semantic-primitives 0.1.0

package/dist/types/constructable/constructable.d.ts

@@ -0,0 +1,150 @@
+/**
+ * SemanticConstructable
+ * A constructor type with LLM-powered semantic understanding
+ *
+ * Implements shared interfaces:
+ * - Semantic<T> - Base semantic wrapper
+ * - Comparable<SemanticConstructable<T>> - Semantic equality comparison
+ */
+import type { LLMClient } from '../../llm/client.ts';
+import type { SemanticEqualsResult, ValidateResult, DetectPatternResult, ImprovementSuggestion } from '../../shared/types.ts';
+import type { Semantic } from '../../shared/interfaces.ts';
+export type { SemanticEqualsResult, ValidateResult, DetectPatternResult, ImprovementSuggestion, } from '../../shared/types.ts';
+/** Constructor type constraint - uses any[] to support constructors with typed parameters */
+export type Constructor<T = unknown> = new (...args: any[]) => T;
+/** Extended semantic equals result with instance differences */
+export interface ConstructableSemanticEqualsResult extends SemanticEqualsResult {
+    instanceDifferences: string[];
+}
+/** Result of analyzing instance shape */
+export interface InstanceShapeResult {
+    properties: Record<string, string>;
+    methods: string[];
+    instanceOf: string[];
+}
+/** Result of createValidated operation */
+export type CreateValidatedResult<T> = {
+    success: true;
+    instance: T;
+} | {
+    success: false;
+    errors: string[];
+};
+/** Documentation format options */
+export type DocFormat = 'jsdoc' | 'markdown' | 'plain';
+/**
+ * SemanticConstructable - Constructor with LLM-powered semantic understanding
+ *
+ * Wraps constructor functions/classes to enable semantic analysis,
+ * validation, and intelligent instantiation patterns.
+ *
+ * @template T - The constructor type
+ */
+export declare class SemanticConstructable<T extends Constructor> implements Semantic<T> {
+    private readonly ctor;
+    private readonly description?;
+    private readonly client;
+    private constructor();
+    /**
+     * Create a SemanticConstructable from a constructor function or class
+     *
+     * @param ctor - Constructor function/class to wrap
+     * @param description - Optional description of what the constructor creates
+     * @param client - Optional LLM client
+     * @returns SemanticConstructable wrapper
+     */
+    static from<T extends Constructor>(ctor: T, description?: string, client?: LLMClient): SemanticConstructable<T>;
+    /**
+     * Get the underlying constructor
+     */
+    valueOf(): T;
+    /**
+     * Get the constructor name
+     */
+    get name(): string;
+    /**
+     * Get the source representation of the constructor
+     */
+    private getSource;
+    /**
+     * Check if an instance was created by this constructor
+     *
+     * @param instance - Instance to check
+     * @returns Whether it's an instance of this constructor
+     */
+    isInstance(instance: unknown): instance is InstanceType<T>;
+    /**
+     * Create an instance using the constructor
+     *
+     * @param args - Constructor arguments
+     * @returns New instance
+     */
+    create(...args: ConstructorParameters<T>): InstanceType<T>;
+    /**
+     * Create an instance with validation
+     *
+     * @param args - Constructor arguments
+     * @returns New instance or validation errors
+     */
+    createValidated(...args: ConstructorParameters<T>): Promise<CreateValidatedResult<InstanceType<T>>>;
+    /**
+     * Check if two constructors create semantically equivalent instances
+     *
+     * @param other - Constructor to compare
+     * @param testArgs - Arguments to test with
+     * @returns Equivalence result
+     */
+    semanticallyEquals(other: Constructor | SemanticConstructable<Constructor>, testArgs?: ConstructorParameters<T>[]): Promise<ConstructableSemanticEqualsResult>;
+    /**
+     * Validate constructor arguments
+     *
+     * @param args - Arguments to validate
+     * @param rules - Additional validation rules
+     * @returns Validation result
+     */
+    validateArgs(args: ConstructorParameters<T>, rules?: string[]): Promise<ValidateResult>;
+    /**
+     * Analyze the shape of instances this constructor creates
+     *
+     * @returns Instance shape analysis
+     */
+    analyzeInstanceShape(): Promise<InstanceShapeResult>;
+    /**
+     * Explain what this constructor creates
+     *
+     * @returns Human-readable explanation
+     */
+    explain(): Promise<string>;
+    /**
+     * Detect design patterns used by this constructor
+     *
+     * @returns Detected patterns
+     */
+    detectPatterns(): Promise<DetectPatternResult>;
+    /**
+     * Generate documentation for this constructor
+     *
+     * @param format - Documentation format (jsdoc, markdown, or plain)
+     * @returns Generated documentation
+     */
+    generateDocs(format?: DocFormat): Promise<string>;
+    /**
+     * Suggest improvements for the constructor
+     *
+     * @returns Suggested improvements
+     */
+    suggestImprovements(): Promise<ImprovementSuggestion[]>;
+    /**
+     * Convert to string representation
+     */
+    toString(): string;
+    /**
+     * Convert to JSON representation
+     */
+    toJSON(): {
+        name: string;
+        description?: string;
+        source: string;
+    };
+}
+//# sourceMappingURL=constructable.d.ts.map

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

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

package/dist/types/constructable/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * SemanticConstructable module exports
+ */
+export { SemanticConstructable, type Constructor, type ConstructableSemanticEqualsResult, type InstanceShapeResult, type CreateValidatedResult, type DocFormat, type SemanticEqualsResult, type ValidateResult, type DetectPatternResult, type ImprovementSuggestion, } from './constructable.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/constructable/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/constructable/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,qBAAqB,EACrB,KAAK,WAAW,EAChB,KAAK,iCAAiC,EACtC,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC"}

package/dist/types/constructable/prompts.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Prompts for SemanticConstructable LLM operations
+ * These prompts enable semantic analysis of constructor functions and classes
+ */
+/**
+ * System prompt for constructable semantic operations
+ */
+export declare const CONSTRUCTABLE_SYSTEM_PROMPT = "You are a semantic constructor analyzer. Your task is to analyze JavaScript/TypeScript class constructors and provide semantic understanding.\n\nYou must respond with valid JSON only, no additional text or explanation.\n\nGuidelines:\n- Consider constructor signatures, parameter types, and instance shapes\n- Analyze design patterns, class relationships, and best practices\n- Provide confidence scores from 0.0 to 1.0\n- Be precise and consistent in your analysis";
+/**
+ * Prompt for semantic equality comparison between constructors
+ */
+export declare function createSemanticallyEqualsPrompt(ctor1Source: string, ctor1Name: string, ctor2Source: string, ctor2Name: string, testArgsStr?: string): string;
+/**
+ * Prompt for validating constructor arguments
+ */
+export declare function createValidateArgsPrompt(ctorSource: string, ctorName: string, argsStr: string, rules?: string[]): string;
+/**
+ * Prompt for analyzing instance shape
+ */
+export declare function createAnalyzeInstanceShapePrompt(ctorSource: string, ctorName: string): string;
+/**
+ * Prompt for explaining what a constructor creates
+ */
+export declare function createExplainPrompt(ctorSource: string, ctorName: string, description?: string): string;
+/**
+ * Prompt for detecting design patterns
+ */
+export declare function createDetectPatternsPrompt(ctorSource: string, ctorName: string): string;
+/**
+ * Prompt for generating documentation
+ */
+export declare function createGenerateDocsPrompt(ctorSource: string, ctorName: string, format: 'jsdoc' | 'markdown' | 'plain'): string;
+/**
+ * Prompt for suggesting improvements
+ */
+export declare function createSuggestImprovementsPrompt(ctorSource: string, ctorName: string): string;
+/**
+ * Prompt for validating instance type
+ */
+export declare function createIsInstancePrompt(ctorSource: string, ctorName: string, instanceStr: string): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/types/constructable/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/types/constructable/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,2BAA2B,sdAQK,CAAC;AAE9C;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CA8BR;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,EAAE,GACf,MAAM,CA6BR;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,CAoBR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAyBR;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,CAuBR;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GACrC,MAAM,CAwBR;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,CAwBR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,MAAM,CAoBR"}

package/dist/types/date/date.d.ts

@@ -0,0 +1,258 @@
+/**
+ * SemanticDate - LLM-enhanced date type with semantic understanding
+ *
+ * Extends the native JavaScript Date with semantic operations including:
+ * - Natural language date parsing
+ * - Context-aware equality comparison
+ * - Intelligent formatting for different contexts
+ * - Period membership checking
+ * - Semantic duration calculations
+ * - Meaning inference
+ *
+ * Implements shared interfaces:
+ * - Semantic<Date> - Base semantic wrapper
+ * - Comparable<Date | SemanticDate> - Semantic equality comparison
+ * - ContextValidatable - Reasonableness checks
+ * - Describable - Human-friendly descriptions
+ */
+import type { LLMConfig, Message } from '../../llm/types.ts';
+import type { SemanticEqualsResult, ReasonableResult, DurationResult, InferMeaningResult } from '../../shared/types.ts';
+import type { Semantic, Comparable, ContextValidatable, Describable } from '../../shared/interfaces.ts';
+export type { SemanticEqualsResult, ReasonableResult, DurationResult, InferMeaningResult, } from '../../shared/types.ts';
+/** Options for date parsing */
+export interface ParseDateOptions {
+    referenceDate?: Date;
+    timezone?: string;
+}
+/** Precision levels for date comparison */
+export type DatePrecision = 'year' | 'month' | 'day' | 'hour' | 'minute' | 'exact';
+/** Options for semantic date equals comparison */
+export interface DateSemanticEqualsOptions {
+    precision?: DatePrecision;
+}
+/** LLM client interface for dependency injection */
+export interface DateLLMClientInterface {
+    chat(options: {
+        messages: Message[];
+        systemPrompt?: string;
+    } & LLMConfig): Promise<{
+        content: string;
+    }>;
+}
+/**
+ * SemanticDate class
+ * Wraps a Date value with LLM-powered semantic operations
+ *
+ * Implements:
+ * - Semantic<Date> - valueOf() returns the date value
+ * - Comparable<Date | SemanticDate> - semanticallyEquals() for comparison
+ * - ContextValidatable - isReasonable() for context-aware validation
+ * - Describable - describe() for human-friendly descriptions
+ */
+export declare class SemanticDate implements Semantic<Date>, Comparable<Date | SemanticDate>, ContextValidatable, Describable {
+    private readonly _value;
+    private readonly _llmClient;
+    private readonly _llmConfig?;
+    /**
+     * Create a SemanticDate instance
+     * @param value - The Date value to wrap
+     * @param llmClient - Optional LLM client for dependency injection (useful for testing)
+     * @param llmConfig - Optional LLM configuration
+     */
+    constructor(value: Date, llmClient?: DateLLMClientInterface, llmConfig?: LLMConfig);
+    /**
+     * Parse a date from natural language
+     * Understands relative expressions, cultural references, and various formats
+     *
+     * @param input - Natural language date expression
+     * @param options - Parsing options including reference date and timezone
+     * @param llmClient - Optional LLM client for dependency injection
+     * @param llmConfig - Optional LLM configuration
+     * @returns SemanticDate instance
+     *
+     * @example
+     * SemanticDate.from("next Friday")
+     * SemanticDate.from("two weeks ago")
+     * SemanticDate.from("the day after tomorrow")
+     * SemanticDate.from("Q4 2024")
+     */
+    static from(input: string | Date, options?: ParseDateOptions, llmClient?: DateLLMClientInterface, llmConfig?: LLMConfig): Promise<SemanticDate>;
+    /**
+     * Check if two dates are semantically equivalent
+     * Considers precision level (day vs exact time)
+     *
+     * @param other - Date to compare with
+     * @param options - Comparison options with optional precision (default: "day")
+     * @returns Equivalence result with confidence
+     *
+     * @example
+     * date1.semanticallyEquals(date2, { precision: "day" })
+     * // Same day regardless of time
+     */
+    semanticallyEquals(other: Date | SemanticDate, options?: Record<string, unknown>): Promise<SemanticEqualsResult>;
+    /**
+     * Describe the date in natural language relative to now
+     *
+     * @param context - Optional context for description (e.g., "relative", "absolute", or custom context)
+     * @returns Human-readable description
+     *
+     * @example
+     * date.describe()
+     * // "3 days ago" or "next Tuesday" or "in 2 weeks"
+     */
+    describe(context?: string): Promise<string>;
+    /**
+     * Format the date for a specific context or audience
+     *
+     * @param context - Formatting context
+     * @returns Formatted date string
+     *
+     * @example
+     * date.formatFor("formal business document") // "January 15, 2024"
+     * date.formatFor("casual chat") // "Jan 15"
+     * date.formatFor("API response") // "2024-01-15T00:00:00Z"
+     */
+    formatFor(context: string): Promise<string>;
+    /**
+     * Check if the date falls within a semantic time period
+     *
+     * @param period - Natural language period description
+     * @returns Whether date is in period
+     *
+     * @example
+     * date.isIn("this week")
+     * date.isIn("business hours")
+     * date.isIn("holiday season")
+     */
+    isIn(period: string): Promise<boolean>;
+    /**
+     * Get the next occurrence of a semantic event
+     *
+     * @param event - Event description
+     * @returns Next occurrence as SemanticDate
+     *
+     * @example
+     * date.next("Monday")
+     * date.next("business day")
+     * date.next("end of month")
+     */
+    next(event: string): Promise<SemanticDate>;
+    /**
+     * Get the previous occurrence of a semantic event
+     *
+     * @param event - Event description
+     * @returns Previous occurrence as SemanticDate
+     *
+     * @example
+     * date.previous("payday")
+     * date.previous("quarter start")
+     */
+    previous(event: string): Promise<SemanticDate>;
+    /**
+     * Calculate semantic duration to another date
+     *
+     * @param other - Target date
+     * @returns Human-readable duration with day counts
+     *
+     * @example
+     * startDate.durationTo(endDate)
+     * // { description: "about 2 weeks", days: 14, businessDays: 10 }
+     */
+    durationTo(other: Date | SemanticDate): Promise<DurationResult>;
+    /**
+     * Validate if the date is reasonable for a context
+     *
+     * @param context - Context for validation
+     * @returns Validation result with reason
+     *
+     * @example
+     * date.isReasonable("birth date")
+     * // { reasonable: false, reason: "Date is in the future" }
+     */
+    isReasonable(context: string): Promise<ReasonableResult>;
+    /**
+     * Add a semantic duration to the date
+     *
+     * @param duration - Natural language duration
+     * @returns New SemanticDate
+     *
+     * @example
+     * date.add("2 business days")
+     * date.add("1 quarter")
+     */
+    add(duration: string): Promise<SemanticDate>;
+    /**
+     * Infer what this date likely represents
+     *
+     * @param context - Additional context
+     * @returns Inferred meaning with type and confidence
+     *
+     * @example
+     * SemanticDate.from("2024-12-25").inferMeaning()
+     * // { meaning: "Christmas Day", type: "holiday", confidence: 0.98 }
+     */
+    inferMeaning(context?: string): Promise<InferMeaningResult>;
+    /**
+     * Get the raw Date value
+     * @returns The underlying Date
+     */
+    valueOf(): Date;
+    /**
+     * Explain the date in a human-readable way.
+     * Implements Explainable interface.
+     *
+     * @param context - Optional context for the explanation
+     * @returns Human-readable explanation
+     */
+    explain(context?: string): Promise<string>;
+    /**
+     * Get the underlying Date's getTime() value
+     * @returns Milliseconds since epoch
+     */
+    getTime(): number;
+    /**
+     * Convert to ISO string
+     */
+    toISOString(): string;
+    /**
+     * Convert to string
+     */
+    toString(): string;
+    /**
+     * Convert to JSON (ISO string)
+     */
+    toJSON(): string;
+    /**
+     * Get the year
+     */
+    getFullYear(): number;
+    /**
+     * Get the month (0-11)
+     */
+    getMonth(): number;
+    /**
+     * Get the day of month (1-31)
+     */
+    getDate(): number;
+    /**
+     * Get the day of week (0-6, Sunday = 0)
+     */
+    getDay(): number;
+    /**
+     * Get the hours (0-23)
+     */
+    getHours(): number;
+    /**
+     * Get the minutes (0-59)
+     */
+    getMinutes(): number;
+    /**
+     * Get the seconds (0-59)
+     */
+    getSeconds(): number;
+    /**
+     * Get the milliseconds (0-999)
+     */
+    getMilliseconds(): number;
+}
+//# sourceMappingURL=date.d.ts.map

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

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

package/dist/types/date/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * SemanticDate module
+ * LLM-enhanced date type with semantic understanding
+ */
+export { SemanticDate, type ParseDateOptions, type DatePrecision, type DateSemanticEqualsOptions, type DateLLMClientInterface, type SemanticEqualsResult, type ReasonableResult, type DurationResult, type InferMeaningResult, } from './date.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/date/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/date/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,kBAAkB,GACxB,MAAM,WAAW,CAAC"}

package/dist/types/date/prompts.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Prompts for SemanticDate LLM operations
+ * These prompts are used for various semantic date operations that require LLM understanding
+ */
+/**
+ * System prompt for date parsing operations
+ */
+export declare const PARSE_DATE_SYSTEM = "You are a date parsing assistant. Your task is to extract dates from natural language expressions.\n\nRules:\n- Parse relative expressions (e.g., \"next Friday\", \"two weeks ago\", \"the day after tomorrow\")\n- Parse quarter references (e.g., \"Q4 2024\", \"end of Q1\")\n- Parse semantic expressions (e.g., \"Thanksgiving 2024\", \"next Christmas\")\n- Use the reference date provided to resolve relative expressions\n- Return dates in ISO 8601 format (YYYY-MM-DDTHH:mm:ss.sssZ)\n- If timezone is provided, adjust accordingly\n- Return null if the input cannot be parsed as a date\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for parsing dates
+ */
+export declare function parseDatePrompt(input: string, referenceDate: string, timezone?: string): string;
+/**
+ * System prompt for semantic equality comparison
+ */
+export declare const SEMANTIC_EQUALS_SYSTEM = "You are a date comparison assistant. Your task is to determine if two dates are semantically equivalent at a specified precision level.\n\nPrecision levels:\n- \"year\": Same year\n- \"month\": Same year and month\n- \"day\": Same calendar day\n- \"hour\": Same day and hour\n- \"minute\": Same day, hour, and minute\n- \"exact\": Exact timestamp match\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for semantic date equality
+ */
+export declare function semanticEqualsPrompt(date1: string, date2: string, precision: string): string;
+/**
+ * System prompt for date description
+ */
+export declare const DESCRIBE_DATE_SYSTEM = "You are a date description assistant. Your task is to describe dates in natural language.\n\nStyles:\n- \"relative\": Express relative to now (e.g., \"3 days ago\", \"in 2 weeks\")\n- \"absolute\": Full date format (e.g., \"January 15, 2024\")\n- \"smart\": Choose the most natural expression based on proximity to now\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for describing dates
+ */
+export declare function describeDatePrompt(date: string, referenceDate: string, style: string): string;
+/**
+ * System prompt for date formatting
+ */
+export declare const FORMAT_DATE_SYSTEM = "You are a date formatting assistant. Your task is to format dates appropriately for different contexts.\n\nConsider:\n- Formal contexts: Use full date formats (e.g., \"January 15, 2024\")\n- Casual contexts: Use abbreviated formats (e.g., \"Jan 15\")\n- API contexts: Use ISO 8601 format (e.g., \"2024-01-15T00:00:00Z\")\n- International contexts: Be aware of locale differences (DD/MM vs MM/DD)\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for formatting dates
+ */
+export declare function formatDatePrompt(date: string, context: string): string;
+/**
+ * System prompt for period checking
+ */
+export declare const IS_IN_PERIOD_SYSTEM = "You are a date period assistant. Your task is to determine if a date falls within a semantic time period.\n\nHandle:\n- Calendar periods: \"this week\", \"last month\", \"Q4\"\n- Business periods: \"business hours\", \"weekend\"\n- Cultural periods: \"holiday season\", \"summer\"\n- Custom periods: Any natural language period description\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for period checking
+ */
+export declare function isInPeriodPrompt(date: string, period: string, referenceDate: string): string;
+/**
+ * System prompt for finding next occurrence
+ */
+export declare const NEXT_OCCURRENCE_SYSTEM = "You are a date calculation assistant. Your task is to find the next occurrence of a semantic event from a given date.\n\nHandle:\n- Days of week: \"Monday\", \"Friday\"\n- Business events: \"business day\", \"end of month\", \"payday\"\n- Calendar events: \"quarter start\", \"end of year\"\n- Holidays: \"Christmas\", \"Thanksgiving\"\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for next occurrence
+ */
+export declare function nextOccurrencePrompt(date: string, event: string): string;
+/**
+ * System prompt for finding previous occurrence
+ */
+export declare const PREVIOUS_OCCURRENCE_SYSTEM = "You are a date calculation assistant. Your task is to find the previous occurrence of a semantic event before a given date.\n\nHandle:\n- Days of week: \"Monday\", \"Friday\"\n- Business events: \"business day\", \"payday\", \"quarter start\"\n- Calendar events: \"end of month\", \"start of year\"\n- Holidays: \"Christmas\", \"Thanksgiving\"\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for previous occurrence
+ */
+export declare function previousOccurrencePrompt(date: string, event: string): string;
+/**
+ * System prompt for duration calculation
+ */
+export declare const DURATION_SYSTEM = "You are a duration calculation assistant. Your task is to calculate and describe the duration between two dates.\n\nProvide:\n- Human-readable description (e.g., \"about 2 weeks\")\n- Exact number of days\n- Number of business days (excluding weekends)\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for duration calculation
+ */
+export declare function durationPrompt(startDate: string, endDate: string): string;
+/**
+ * System prompt for reasonableness validation
+ */
+export declare const IS_REASONABLE_SYSTEM = "You are a date validation assistant. Your task is to determine if a date is reasonable for a given context.\n\nConsider:\n- Birth dates: Should be in the past, within human lifespan\n- Future events: Should not be too far in the future for certain contexts\n- Historical events: Should match known historical timelines\n- Domain-specific constraints: e.g., employment start dates, graduation dates\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for reasonableness check
+ */
+export declare function isReasonablePrompt(date: string, context: string, referenceDate: string): string;
+/**
+ * System prompt for adding duration
+ */
+export declare const ADD_DURATION_SYSTEM = "You are a date arithmetic assistant. Your task is to add a semantic duration to a date.\n\nHandle:\n- Standard durations: \"2 days\", \"3 weeks\", \"1 month\"\n- Business durations: \"2 business days\", \"next business week\"\n- Semantic durations: \"1 quarter\", \"half a year\"\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for adding duration
+ */
+export declare function addDurationPrompt(date: string, duration: string): string;
+/**
+ * System prompt for meaning inference
+ */
+export declare const INFER_MEANING_SYSTEM = "You are a date meaning assistant. Your task is to infer what a specific date likely represents.\n\nConsider:\n- Holidays: Christmas (Dec 25), Thanksgiving (4th Thursday of Nov), etc.\n- Cultural events: New Year's Day, Independence Day\n- Religious observances: Easter, Hanukkah\n- Business events: Tax day, fiscal year end\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for meaning inference
+ */
+export declare function inferMeaningPrompt(date: string, context?: string): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/types/date/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/types/date/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,onBAWO,CAAC;AAEtC;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CASR;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,6YAUE,CAAC;AAEtC;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,CASR;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,2WAOI,CAAC;AAEtC;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,GACZ,MAAM,CASR;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,wbAQM,CAAC;AAEtC;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAQtE;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,gYAQK,CAAC;AAEtC;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,GACpB,MAAM,CASR;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,4XAQE,CAAC;AAEtC;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,MAAM,CAQR;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,oYAQF,CAAC;AAEtC;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,MAAM,CAQR;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,ySAOS,CAAC;AAEtC;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAQzE;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,0bAQI,CAAC;AAEtC;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,GACpB,MAAM,CASR;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,oUAOK,CAAC;AAEtC;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQxE;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,gXAQI,CAAC;AAEtC;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAQzE"}