semantic-primitives 0.1.0

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

@@ -0,0 +1,63 @@
+/**
+ * Prompts for SemanticArray LLM operations
+ * These prompts enable semantic operations on array collections
+ */
+/**
+ * System prompt for array semantic operations
+ */
+export declare const ARRAY_SYSTEM_PROMPT = "You are a semantic array analyzer. Your task is to analyze arrays and their elements to provide semantic understanding.\n\nYou must respond with valid JSON only, no additional text or explanation.\n\nGuidelines:\n- Consider element meanings, relationships, and patterns\n- Provide confidence scores from 0.0 to 1.0\n- Be precise and consistent in your analysis\n- Handle both primitive and complex object arrays";
+/**
+ * Prompt for semantic equality comparison
+ */
+export declare function createSemanticallyEqualsPrompt(array1: unknown[], array2: unknown[], options?: {
+    orderMatters?: boolean;
+    threshold?: number;
+}): string;
+/**
+ * Prompt for semantic filtering
+ */
+export declare function createSemanticFilterPrompt(array: unknown[], criteria: string): string;
+/**
+ * Prompt for semantic grouping
+ */
+export declare function createSemanticGroupPrompt(array: unknown[], criteria: string): string;
+/**
+ * Prompt for semantic sorting
+ */
+export declare function createSemanticSortPrompt(array: unknown[], criteria: string): string;
+/**
+ * Prompt for semantic search
+ */
+export declare function createSemanticSearchPrompt(array: unknown[], criteria: string, options?: {
+    limit?: number;
+}): string;
+/**
+ * Prompt for pattern detection
+ */
+export declare function createDetectPatternsPrompt(array: unknown[]): string;
+/**
+ * Prompt for summarization
+ */
+export declare function createSummarizePrompt(array: unknown[], options?: {
+    maxLength?: number;
+    focus?: string;
+}): string;
+/**
+ * Prompt for semantic unique (deduplication)
+ */
+export declare function createSemanticUniquePrompt(array: unknown[], options?: {
+    threshold?: number;
+}): string;
+/**
+ * Prompt for validation
+ */
+export declare function createValidatePrompt(array: unknown[], rules: string[]): string;
+/**
+ * Prompt for enrichment
+ */
+export declare function createEnrichPrompt(array: unknown[], enrichments: Record<string, string>): string;
+/**
+ * Prompt for inferring element type
+ */
+export declare function createInferElementTypePrompt(array: unknown[]): string;
+//# sourceMappingURL=prompts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/types/array/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB,gaAQkB,CAAC;AAEnD;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,OAAO,EAAE,EACjB,MAAM,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD,MAAM,CAwBR;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EAAE,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EAAE,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,CAkBR;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EAAE,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EAAE,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,MAAM,CAqBR;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAoBnE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EAAE,EAChB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,MAAM,CA2BR;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EAAE,EAChB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,MAAM,CAqBR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EAAE,EAChB,KAAK,EAAE,MAAM,EAAE,GACd,MAAM,CAiBR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EAAE,EAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,MAAM,CAuBR;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAkBrE"}

package/dist/types/blob-file/blob.d.ts

@@ -0,0 +1,188 @@
+/**
+ * SemanticBlob - LLM-enhanced Blob type with semantic understanding
+ *
+ * Extends the native Blob with semantic operations including:
+ * - Content type detection beyond MIME headers
+ * - Semantic equivalence comparison
+ * - Content analysis and validation
+ * - Safety assessment
+ *
+ * Implements shared interfaces:
+ * - Semantic<Blob> - Base semantic wrapper
+ * - Comparable<Blob> - Semantic equality comparison
+ * - Explainable - Human-readable explanations
+ */
+import type { LLMConfig, Message } from '../../llm/types.ts';
+import type { SemanticEqualsResult } from '../../shared/types.ts';
+import type { Semantic, Comparable, Explainable } from '../../shared/interfaces.ts';
+export type { SemanticEqualsResult } from '../../shared/types.ts';
+/** Extended semantic equals result with note */
+export interface BlobSemanticEqualsResult extends SemanticEqualsResult {
+    note?: string;
+}
+/** Result of content type detection */
+export interface ContentTypeResult {
+    type: string;
+    declaredType: string;
+    mismatch: boolean;
+    confidence: number;
+}
+/** Result of blob analysis */
+export interface AnalyzeResult {
+    type: string;
+    details: Record<string, unknown>;
+}
+/** Result of validation for a use case */
+export interface ValidateForResult {
+    valid: boolean;
+    reason?: string;
+    suggestions?: string[];
+}
+/** Result of safety assessment */
+export interface SafetyResult {
+    safe: boolean;
+    warnings: string[];
+    scanned: string[];
+}
+/** LLM client interface for dependency injection */
+export interface BlobLLMClientInterface {
+    chat(options: {
+        messages: Message[];
+        systemPrompt?: string;
+    } & LLMConfig): Promise<{
+        content: string;
+    }>;
+}
+/**
+ * SemanticBlob class
+ * Wraps a Blob value with LLM-powered semantic operations
+ *
+ * Implements:
+ * - Semantic<Blob> - valueOf() returns the Blob value
+ * - Comparable<Blob> - semanticallyEquals() for comparison
+ * - Explainable - explain() for human-readable explanations
+ */
+export declare class SemanticBlob implements Semantic<Blob>, Comparable<Blob, BlobSemanticEqualsResult>, Explainable {
+    protected readonly _value: Blob;
+    protected readonly _llmClient: BlobLLMClientInterface;
+    protected readonly _llmConfig?: LLMConfig;
+    /**
+     * Create a SemanticBlob instance
+     * @param value - The Blob value to wrap
+     * @param llmClient - Optional LLM client for dependency injection (useful for testing)
+     * @param llmConfig - Optional LLM configuration
+     */
+    constructor(value: Blob, llmClient?: BlobLLMClientInterface, llmConfig?: LLMConfig);
+    /**
+     * Create a SemanticBlob from existing Blob or data.
+     *
+     * @param data - Blob, ArrayBuffer, or string
+     * @param options - Blob options
+     * @param llmClient - Optional LLM client for dependency injection
+     * @param llmConfig - Optional LLM configuration
+     * @returns SemanticBlob instance
+     *
+     * @example
+     * SemanticBlob.from(arrayBuffer, { type: "image/png" })
+     */
+    static from(data: Blob | ArrayBuffer | Uint8Array | string, options?: BlobPropertyBag, llmClient?: BlobLLMClientInterface, llmConfig?: LLMConfig): SemanticBlob;
+    /**
+     * Get a preview of the blob content as hex
+     */
+    protected getPreview(maxBytes?: number): Promise<string>;
+    /**
+     * Check if two blobs are semantically equivalent.
+     *
+     * @param other - Blob to compare
+     * @returns Equivalence result
+     *
+     * @example
+     * blob1.semanticallyEquals(blob2)
+     * // { equivalent: true, note: "Same image, different compression", confidence: 0.9 }
+     */
+    semanticallyEquals(other: Blob, _options?: Record<string, unknown>): Promise<BlobSemanticEqualsResult>;
+    /**
+     * Detect the actual content type (not just MIME header).
+     *
+     * @returns Content detection result
+     *
+     * @example
+     * blob.detectContentType()
+     * // { type: "image/png", declaredType: "application/octet-stream", mismatch: true }
+     */
+    detectContentType(): Promise<ContentTypeResult>;
+    /**
+     * Analyze the blob contents.
+     *
+     * @returns Content analysis
+     *
+     * @example
+     * imageBlob.analyze()
+     * // { type: "image", details: { format: "PNG", hasTransparency: true } }
+     */
+    analyze(): Promise<AnalyzeResult>;
+    /**
+     * Validate the blob for a specific use case.
+     *
+     * @param useCase - Intended use
+     * @returns Validation result
+     *
+     * @example
+     * blob.validateFor("profile picture")
+     * // { valid: false, reason: "Image dimensions too small (min 200x200)" }
+     */
+    validateFor(useCase: string): Promise<ValidateForResult>;
+    /**
+     * Check if the blob is safe (no malicious content).
+     *
+     * @returns Safety assessment
+     *
+     * @example
+     * blob.isSafe()
+     * // { safe: true, warnings: [], scanned: ["magic-bytes", "extension-match"] }
+     */
+    isSafe(): Promise<SafetyResult>;
+    /**
+     * Explain what this blob contains.
+     *
+     * @param _context - Optional context (unused, for interface compatibility)
+     * @returns Human-readable explanation
+     */
+    explain(_context?: string): Promise<string>;
+    /**
+     * Get a summary of blob metadata.
+     *
+     * @returns Metadata summary
+     */
+    getMetadata(): Promise<Record<string, unknown>>;
+    /**
+     * Get the raw Blob value
+     * @returns The underlying Blob
+     */
+    valueOf(): Blob;
+    /**
+     * Get the MIME type
+     */
+    get type(): string;
+    /**
+     * Get the size in bytes
+     */
+    get size(): number;
+    /**
+     * Slice the blob
+     */
+    slice(start?: number, end?: number, contentType?: string): Blob;
+    /**
+     * Get the blob as ArrayBuffer
+     */
+    arrayBuffer(): Promise<ArrayBuffer>;
+    /**
+     * Get the blob as text
+     */
+    text(): Promise<string>;
+    /**
+     * Get a stream of the blob
+     */
+    stream(): ReadableStream<Uint8Array>;
+}
+//# sourceMappingURL=blob.d.ts.map

package/dist/types/blob-file/blob.d.ts.map

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

package/dist/types/blob-file/file.d.ts

@@ -0,0 +1,144 @@
+/**
+ * SemanticFile - LLM-enhanced File type with semantic understanding
+ *
+ * Extends SemanticBlob with file-specific semantic operations including:
+ * - Filename validation
+ * - Extension matching
+ * - Category inference
+ * - Filename suggestions
+ *
+ * Implements shared interfaces:
+ * - Semantic<File> - Base semantic wrapper
+ * - Comparable<File> - Semantic equality comparison
+ * - Explainable - Human-readable explanations
+ */
+import type { LLMConfig } from '../../llm/types.ts';
+import { SemanticBlob, type BlobLLMClientInterface } from './blob.ts';
+import { SemanticDate } from '../date/date.ts';
+export type { BlobSemanticEqualsResult, ContentTypeResult, AnalyzeResult, ValidateForResult, SafetyResult, BlobLLMClientInterface, } from './blob.ts';
+/** Result of filename validation */
+export interface FilenameValidationResult {
+    valid: boolean;
+    issues: string[];
+    suggestions: string[];
+}
+/** Result of extension validation */
+export interface ExtensionValidationResult {
+    matches: boolean;
+    actualType: string;
+    expectedType: string;
+}
+/** Result of category inference */
+export interface CategoryResult {
+    category: string;
+    subcategory?: string;
+    confidence: number;
+}
+/** Result of filename suggestion */
+export interface FilenameSuggestionResult {
+    suggested: string;
+    reason: string;
+}
+/** LLM client interface for dependency injection */
+export type FileLLMClientInterface = BlobLLMClientInterface;
+/**
+ * SemanticFile class
+ * Wraps a File value with LLM-powered semantic operations
+ *
+ * Extends SemanticBlob with file-specific capabilities:
+ * - validateFilename() for filename rule validation
+ * - validateExtension() for extension/content matching
+ * - inferCategory() for file categorization
+ * - suggestFilename() for better naming suggestions
+ * - getLastModified() for semantic date access
+ */
+export declare class SemanticFile extends SemanticBlob {
+    protected readonly _file: File;
+    protected readonly _filename: string;
+    protected readonly _lastModified: number;
+    /**
+     * Create a SemanticFile instance
+     * @param file - The File value to wrap
+     * @param llmClient - Optional LLM client for dependency injection (useful for testing)
+     * @param llmConfig - Optional LLM configuration
+     */
+    constructor(file: File, llmClient?: FileLLMClientInterface, llmConfig?: LLMConfig);
+    /**
+     * Create a SemanticFile from File or Blob.
+     *
+     * @param file - File or Blob with name
+     * @param filename - Optional filename override
+     * @param llmClient - Optional LLM client for dependency injection
+     * @param llmConfig - Optional LLM configuration
+     * @returns SemanticFile instance
+     *
+     * @example
+     * SemanticFile.fromFile(inputElement.files[0])
+     */
+    static fromFile(file: File | Blob, filename?: string, llmClient?: FileLLMClientInterface, llmConfig?: LLMConfig): SemanticFile;
+    /**
+     * Validate the filename.
+     *
+     * @param rules - Filename validation rules
+     * @returns Validation result
+     *
+     * @example
+     * file.validateFilename(["no spaces", "lowercase only"])
+     * // { valid: false, issues: ["contains spaces"], suggestions: ["use-kebab-case.pdf"] }
+     */
+    validateFilename(rules?: string[]): Promise<FilenameValidationResult>;
+    /**
+     * Check if file extension matches content.
+     *
+     * @returns Match result
+     *
+     * @example
+     * file.validateExtension()
+     * // { matches: false, actualType: "image/png", expectedType: "image/jpeg" }
+     */
+    validateExtension(): Promise<ExtensionValidationResult>;
+    /**
+     * Infer the file category.
+     *
+     * @returns File category
+     *
+     * @example
+     * file.inferCategory()
+     * // { category: "document", subcategory: "spreadsheet", confidence: 0.95 }
+     */
+    inferCategory(): Promise<CategoryResult>;
+    /**
+     * Suggest a better filename.
+     *
+     * @returns Suggested filename
+     *
+     * @example
+     * file.suggestFilename()
+     * // { suggested: "invoice-2024-01.pdf", reason: "Based on document content" }
+     */
+    suggestFilename(): Promise<FilenameSuggestionResult>;
+    /**
+     * Get the file's modification timestamp as SemanticDate.
+     *
+     * @returns Last modified date with semantic capabilities
+     */
+    getLastModified(): SemanticDate;
+    /**
+     * Get the raw File value
+     * @returns The underlying File
+     */
+    valueOf(): File;
+    /**
+     * Get the filename
+     */
+    get name(): string;
+    /**
+     * Get the last modified timestamp
+     */
+    get lastModified(): number;
+    /**
+     * Get the webkitRelativePath (if available)
+     */
+    get webkitRelativePath(): string;
+}
+//# sourceMappingURL=file.d.ts.map

package/dist/types/blob-file/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../src/types/blob-file/file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAW,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,KAAK,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAa/C,YAAY,EACV,wBAAwB,EACxB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,GACvB,MAAM,WAAW,CAAC;AAEnB,oCAAoC;AACpC,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,qCAAqC;AACrC,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,oCAAoC;AACpC,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oDAAoD;AACpD,MAAM,MAAM,sBAAsB,GAAG,sBAAsB,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IAC/B,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IACrC,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAEzC;;;;;OAKG;gBAED,IAAI,EAAE,IAAI,EACV,SAAS,CAAC,EAAE,sBAAsB,EAClC,SAAS,CAAC,EAAE,SAAS;IAQvB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,QAAQ,CACb,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,sBAAsB,EAClC,SAAS,CAAC,EAAE,SAAS,GACpB,YAAY;IAUf;;;;;;;;;OASG;IACG,gBAAgB,CAAC,KAAK,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAiB/E;;;;;;;;OAQG;IACG,iBAAiB,IAAI,OAAO,CAAC,yBAAyB,CAAC;IAuB7D;;;;;;;;OAQG;IACG,aAAa,IAAI,OAAO,CAAC,cAAc,CAAC;IAqB9C;;;;;;;;OAQG;IACG,eAAe,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAuB1D;;;;OAIG;IACH,eAAe,IAAI,YAAY;IAI/B;;;OAGG;IACM,OAAO,IAAI,IAAI;IAMxB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,MAAM,CAE/B;CACF"}

package/dist/types/blob-file/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * SemanticBlob and SemanticFile Module
+ * LLM-enhanced Blob and File types with semantic understanding
+ */
+export { SemanticBlob, type BlobSemanticEqualsResult, type ContentTypeResult, type AnalyzeResult, type ValidateForResult, type SafetyResult, type BlobLLMClientInterface, } from './blob.ts';
+export { SemanticFile, type FilenameValidationResult, type ExtensionValidationResult, type CategoryResult, type FilenameSuggestionResult, type FileLLMClientInterface, } from './file.ts';
+export type { SemanticEqualsResult } from '../../shared/types.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/blob-file/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/blob-file/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,YAAY,EACZ,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,sBAAsB,GAC5B,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,YAAY,EACZ,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,GAC5B,MAAM,WAAW,CAAC;AAGnB,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/types/blob-file/prompts.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Prompts for SemanticBlob and SemanticFile LLM operations
+ * These prompts are used for various semantic blob/file operations that require LLM understanding
+ */
+/**
+ * System prompt for semantic blob equality comparison
+ */
+export declare const SEMANTIC_EQUALS_SYSTEM = "You are a binary data comparison assistant. Your task is to determine if two blobs are semantically equivalent.\n\nConsider these factors when comparing:\n- Content type and MIME types\n- Binary signatures and magic bytes\n- Content structure similarity\n- Whether content represents the same data in different formats/compressions\n- Size differences and their implications\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for semantic blob equality
+ */
+export declare function semanticEqualsPrompt(blob1Info: {
+    type: string;
+    size: number;
+    preview: string;
+}, blob2Info: {
+    type: string;
+    size: number;
+    preview: string;
+}): string;
+/**
+ * System prompt for content type detection
+ */
+export declare const DETECT_CONTENT_TYPE_SYSTEM = "You are a file type detection assistant. Your task is to detect the actual content type of binary data based on magic bytes and content signatures.\n\nCommon magic byte patterns:\n- PNG: 89 50 4E 47 0D 0A 1A 0A\n- JPEG: FF D8 FF\n- GIF: 47 49 46 38\n- PDF: 25 50 44 46\n- ZIP: 50 4B 03 04\n- MP3: 49 44 33 or FF FB\n- MP4: various (ftyp signature)\n- HTML/XML: text patterns\n- JSON: starts with { or [\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for content type detection
+ */
+export declare function detectContentTypePrompt(declaredType: string, magicBytes: string, size: number): string;
+/**
+ * System prompt for blob analysis
+ */
+export declare const ANALYZE_BLOB_SYSTEM = "You are a binary data analysis assistant. Your task is to analyze blob contents and provide detailed information about the data.\n\nFor images, consider: dimensions, color depth, transparency, compression\nFor documents: format, potential content type\nFor audio/video: format, potential duration, codec hints\nFor text-based: encoding, structure\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for blob analysis
+ */
+export declare function analyzeBlobPrompt(type: string, size: number, preview: string): string;
+/**
+ * System prompt for use case validation
+ */
+export declare const VALIDATE_FOR_SYSTEM = "You are a file validation assistant. Your task is to validate if a blob is suitable for a specific use case.\n\nConsider:\n- Content type appropriateness\n- Size constraints for the use case\n- Format compatibility\n- Quality requirements\n- Security considerations\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for use case validation
+ */
+export declare function validateForPrompt(useCase: string, type: string, size: number, preview: string): string;
+/**
+ * System prompt for safety assessment
+ */
+export declare const IS_SAFE_SYSTEM = "You are a file safety assessment assistant. Your task is to assess whether a blob is safe (no malicious content indicators).\n\nSafety checks to consider:\n- Magic byte validation (type matches declared type)\n- Suspicious patterns (embedded scripts, polyglot files)\n- Known malicious signatures\n- Extension/type mismatches\n- Unusual size characteristics\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for safety assessment
+ */
+export declare function isSafePrompt(declaredType: string, detectedType: string, size: number, magicBytes: string): string;
+/**
+ * System prompt for blob explanation
+ */
+export declare const EXPLAIN_BLOB_SYSTEM = "You are a file description assistant. Your task is to explain what a blob contains in human-readable terms.\n\nProvide a clear, concise description that a non-technical user could understand.\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for blob explanation
+ */
+export declare function explainBlobPrompt(type: string, size: number, preview: string): string;
+/**
+ * System prompt for metadata extraction
+ */
+export declare const GET_METADATA_SYSTEM = "You are a file metadata extraction assistant. Your task is to extract and infer metadata from blob data.\n\nExtract information like:\n- Content type and format\n- Size information\n- Structural characteristics\n- Format-specific metadata hints\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for metadata extraction
+ */
+export declare function getMetadataPrompt(type: string, size: number, preview: string): string;
+/**
+ * System prompt for filename validation
+ */
+export declare const VALIDATE_FILENAME_SYSTEM = "You are a filename validation assistant. Your task is to validate filenames against specified rules.\n\nCommon filename rules:\n- no spaces: filename should not contain spaces\n- lowercase only: all characters should be lowercase\n- alphanumeric: only letters, numbers, and allowed separators\n- no special characters: avoid special characters\n- max length: reasonable filename length\n- valid extension: extension matches content\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for filename validation
+ */
+export declare function validateFilenamePrompt(filename: string, rules: string[]): string;
+/**
+ * System prompt for extension validation
+ */
+export declare const VALIDATE_EXTENSION_SYSTEM = "You are a file extension validation assistant. Your task is to check if a file's extension matches its actual content type.\n\nConsider:\n- Common extension mappings\n- MIME type to extension relationships\n- Content detection results\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for extension validation
+ */
+export declare function validateExtensionPrompt(filename: string, actualType: string, detectedType: string): string;
+/**
+ * System prompt for category inference
+ */
+export declare const INFER_CATEGORY_SYSTEM = "You are a file categorization assistant. Your task is to infer the category of a file based on its name, type, and content.\n\nCategories to consider:\n- document (subcategories: text, spreadsheet, presentation, pdf)\n- image (subcategories: photo, icon, vector, screenshot)\n- video (subcategories: movie, clip, animation)\n- audio (subcategories: music, voice, sound-effect)\n- archive (subcategories: compressed, backup)\n- code (subcategories: source, config, script)\n- data (subcategories: database, dataset, export)\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for category inference
+ */
+export declare function inferCategoryPrompt(filename: string, type: string, size: number): string;
+/**
+ * System prompt for filename suggestion
+ */
+export declare const SUGGEST_FILENAME_SYSTEM = "You are a filename suggestion assistant. Your task is to suggest a better, more descriptive filename based on file content and context.\n\nConsider:\n- Content type and format\n- Descriptive naming conventions\n- Date/timestamp inclusion if appropriate\n- Proper extension\n- Clean, readable format\n\nAlways respond with valid JSON only.";
+/**
+ * User prompt template for filename suggestion
+ */
+export declare function suggestFilenamePrompt(currentFilename: string, type: string, contentHints: string): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/types/blob-file/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/types/blob-file/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;GAEG;AACH,eAAO,MAAM,sBAAsB,maASE,CAAC;AAEtC;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC1D,SAAS,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzD,MAAM,CAeR;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,+bAaF,CAAC;AAEtC;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,MAAM,CASR;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,uYAOK,CAAC;AAEtC;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,MAAM,CAcR;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,sTASK,CAAC;AAEtC;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,MAAM,CAUR;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,kZASU,CAAC;AAEtC;;GAEG;AACH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,MAAM,CAUR;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,4OAIK,CAAC;AAEtC;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,MAAM,CASR;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,iSAQK,CAAC;AAEtC;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,MAAM,CASR;AAMD;;GAEG;AACH,eAAO,MAAM,wBAAwB,4dAUA,CAAC;AAEtC;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAQhF;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,uRAOD,CAAC;AAEtC;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,MAAM,CASR;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,ujBAWG,CAAC;AAEtC;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM,CASR;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,uVASC,CAAC;AAEtC;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,GACnB,MAAM,CASR"}