@ai-pip/core 0.1.4 → 0.1.5

package/README.md

@@ -21,10 +21,13 @@ El protocolo AI-PIP está compuesto por las siguientes capas:
 - **ISL (Instruction Sanitization Layer)**: Sanitiza instrucciones según nivel de confianza
 - **CPE (Cryptographic Prompt Envelope)**: Genera envoltorio criptográfico con firma HMAC-SHA256
 
-### ⏳ Capas Pendientes
+### 🔧 Features Compartidas
 
-- **AAL (Agent Action Lock)**: Bloqueo de acciones de agentes
-- **Model Gateway**: Interfaz con modelos de IA
+- **Shared**: Funciones compartidas y linaje global e incremental (no es una capa, son features compartidas entre capas)
+
+### 📝 Nota sobre AAL y Model Gateway
+
+**AAL (Agent Action Lock)** y **Model Gateway** son componentes del SDK, no del core semántico. El core semántico se enfoca en funciones puras y señales, mientras que estas capas requieren decisiones operativas y efectos secundarios que pertenecen a la implementación (SDK).
 
 ## 📦 Instalación
 
@@ -38,50 +41,67 @@ yarn add @ai-pip/core
 
 ## 🚀 Uso Básico
 
-### Importar capas completas
+### Importar desde el paquete principal
 
 ```typescript
 import { segment, sanitize, envelope } from '@ai-pip/core'
-```
-
-### Importar capas específicas
-
-```typescript
-// CSL - Context Segmentation Layer
-import { segment, classifySource } from '@ai-pip/core/csl'
-
-// ISL - Instruction Sanitization Layer
-import { sanitize, createPolicyRule } from '@ai-pip/core/isl'
-
-// CPE - Cryptographic Prompt Envelope
-import { envelope, createNonce } from '@ai-pip/core/cpe'
-
-// Shared utilities
-import { addLineageEntry } from '@ai-pip/core/shared'
+import type { CSLResult, ISLResult, CPEResult } from '@ai-pip/core'
 ```
 
 ### Ejemplo Completo
 
 ```typescript
-import { segment } from '@ai-pip/core/csl'
-import { sanitize } from '@ai-pip/core/isl'
-import { envelope } from '@ai-pip/core/cpe'
+import { segment, sanitize, envelope } from '@ai-pip/core'
+import type { CSLResult, ISLResult, CPEResult } from '@ai-pip/core'
 
 // 1. Segmentar contenido (CSL)
-const cslResult = segment({
+const cslResult: CSLResult = segment({
   content: 'User input here',
   source: 'UI',
   metadata: {}
 })
 
 // 2. Sanitizar contenido (ISL)
-const islResult = sanitize(cslResult)
+const islResult: ISLResult = sanitize(cslResult)
 
 // 3. Generar envelope criptográfico (CPE)
 const secretKey = 'your-secret-key'
-const cpeResult = envelope(islResult, secretKey)
+const cpeResult: CPEResult = envelope(islResult, secretKey)
 
 // cpeResult.envelope contiene el prompt protegido
+console.log(JSON.stringify(cpeResult, null, 2))
+```
+
+### Ejemplo con funciones adicionales
+
+```typescript
+import {
+  segment,
+  sanitize,
+  envelope,
+  classifySource,
+  addLineageEntry,
+  createNonce
+} from '@ai-pip/core'
+import type {
+  CSLResult,
+  ISLResult,
+  CPEResult,
+  Source,
+  TrustLevel
+} from '@ai-pip/core'
+
+// Clasificar un source
+const trust = classifySource('UI' as Source)
+
+// Agregar entrada de linaje
+const updatedLineage = addLineageEntry(cslResult.lineage, {
+  step: 'CUSTOM',
+  timestamp: Date.now()
+})
+
+// Generar nonce
+const nonce = createNonce()
 ```
 
 ## 📚 Documentación
@@ -92,11 +112,14 @@ const cpeResult = envelope(islResult, secretKey)
 - **[ISL - Instruction Sanitization Layer](docs/layer/isl.md)**: Documentación completa de la capa de sanitización
 - **[CPE - Cryptographic Prompt Envelope](docs/layer/cpe.md)**: Documentación completa del envoltorio criptográfico
 
+
+- **[Shared - Features Compartidas](docs/layer/shared.md)**: Funciones compartidas y linaje global
+
 ### Documentación General
 
+- **[Whitepaper](docs/whitepaper.md)**: Especificación técnica completa del protocolo AI-PIP
+- **[Roadmap](docs/roadmap.md)**: Plan de desarrollo y evolución del protocolo
 - **[Arquitectura](docs/architecture.md)**: Arquitectura semántica del protocolo
-- **[Roadmap](docs/roadmap.md)**: Plan de desarrollo y evolución
-- **[Whitepaper](docs/whitepaper.md)**: Especificación técnica completa
 - **[SDK Reference](docs/SDK.md)**: Referencia para desarrollo de SDKs
 
 ## 🧪 Testing
@@ -204,10 +227,48 @@ Las contribuciones son bienvenidas. Por favor:
 - **NPM Package**: https://www.npmjs.com/package/@ai-pip/core
 - **GitHub**: https://github.com/AI-PIP/ai-pip-core
 
+## 🔮 Mejoras Futuras
+
+### Imports por Capa Específica
+
+Actualmente, se recomienda importar desde el paquete principal (`@ai-pip/core`) para evitar confusiones con nombres similares entre capas. En futuras versiones, se mejorará el soporte para imports directos desde capas específicas:
+
+```typescript
+// Futuro (en desarrollo)
+import { segment } from '@ai-pip/core/csl'
+import { sanitize } from '@ai-pip/core/isl'
+import { envelope } from '@ai-pip/core/cpe'
+```
+
+Esto permitirá:
+- **Mejor organización**: Importar solo lo necesario de cada capa
+- **Evitar conflictos**: Prevenir confusiones con funciones de nombres similares
+- **Tree-shaking mejorado**: Los bundlers podrán eliminar código no usado más eficientemente
+
+**Nota**: Los exports por capa están técnicamente disponibles, pero se recomienda usar el paquete principal hasta que se complete la optimización de resolución de módulos.
+
 ---
 
 ## 📝 CHANGELOG
 
+### [0.1.5] - 2025-12-28
+
+#### 📚 Mejoras de Documentación
+- **README actualizado**: Agregados links a whitepaper, roadmap y documentación completa de capas
+- **Roadmap actualizado**: Agregado SDK-browser en Fase 4, actualizado estado de Fase 1 a 100% completado
+- **Clarificación de arquitectura**: Corregida documentación sobre Shared (no es una capa, son features compartidas)
+- **Nota sobre SDK**: Actualizada explicación sobre AAL y Model Gateway (son componentes del SDK, no del core)
+
+#### 🔧 Optimizaciones
+- **Reducción de tamaño del paquete**: Removido `src/` del campo `files` en `package.json` para hacer el paquete más liviano
+- **Paquete optimizado**: Solo se incluyen archivos necesarios (`dist/`, `tsconfig.json`, `README.md`, `LICENSE`)
+
+#### ✨ Mejoras
+- **Documentación de capas**: Agregado link a documentación de Shared (features compartidas)
+- **Organización de documentación**: Reorganizada sección de documentación con prioridad en whitepaper y roadmap
+
+---
+
 ### [0.1.3] - 2025-12-28
 
 #### ✨ Nuevas características
@@ -293,5 +354,5 @@ Las contribuciones son bienvenidas. Por favor:
 
 ---
 
-**Versión actual**: 0.1.3  
-**Estado**: Fase 1 - Capas Core (60% completado)
+**Versión actual**: 0.1.5  
+**Estado**: Fase 1 - Capas Core (100% completado)

package/dist/index.d.ts

@@ -2,13 +2,17 @@
  * @ai-pip/core - Core implementation of the AI-PIP protocol
  *
  * @remarks
- * Main entry point that re-exports all layers (CSL, ISL, Shared)
+ * Main entry point that re-exports all layers (CSL, ISL, CPE, Shared)
  *
- * You can also import specific layers:
+ * You can import from specific layers:
  * - import { segment } from '@ai-pip/core/csl'
  * - import { sanitize } from '@ai-pip/core/isl'
- * - import { addLineageEntry } from '@ai-pip/core/shared'
  * - import { envelope } from '@ai-pip/core/cpe'
+ *
+ * Or import everything from the main entry point:
+ * - import { addLineageEntry, segment, sanitize, envelope } from '@ai-pip/core'
+ *
+ * Note: Shared functions are only available from the main entry point, not as a subpath.
  */
 export { segment, classifySource, classifyOrigin, initLineage, createLineageEntry, generateId, splitByContextRules, OriginType, TrustLevelType, ClassificationError, SegmentationError } from './csl';
 export type { HashAlgorithm, Source, CSLInput, CSLSegment, CSLResult, TrustLevel, Origin, LineageEntry, ContentHash } from './csl';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EACL,OAAO,EACP,cAAc,EACd,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,mBAAmB,EACnB,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,OAAO,CAAA;AACd,YAAY,EACV,aAAa,EACb,MAAM,EACN,QAAQ,EACR,UAAU,EACV,SAAS,EACT,UAAU,EACV,MAAM,EACN,YAAY,EACZ,WAAW,EACZ,MAAM,OAAO,CAAA;AAGd,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAChC,YAAY,EACV,SAAS,EACT,aAAa,EACb,QAAQ,EACR,aAAa,EACb,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACV,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,OAAO,EACR,MAAM,OAAO,CAAA;AACd,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,6BAA6B,EAC7B,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EAClB,MAAM,OAAO,CAAA;AAGd,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,UAAU,CAAA;AAGjB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,wBAAwB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AACnK,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,kBAAkB,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EACL,OAAO,EACP,cAAc,EACd,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,mBAAmB,EACnB,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,OAAO,CAAA;AACd,YAAY,EACV,aAAa,EACb,MAAM,EACN,QAAQ,EACR,UAAU,EACV,SAAS,EACT,UAAU,EACV,MAAM,EACN,YAAY,EACZ,WAAW,EACZ,MAAM,OAAO,CAAA;AAGd,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAChC,YAAY,EACV,SAAS,EACT,aAAa,EACb,QAAQ,EACR,aAAa,EACb,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,UAAU,EACV,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,OAAO,EACR,MAAM,OAAO,CAAA;AACd,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,6BAA6B,EAC7B,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EAClB,MAAM,OAAO,CAAA;AAGd,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,UAAU,CAAA;AAGjB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,wBAAwB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AACnK,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,kBAAkB,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA"}

package/dist/index.js

@@ -2,13 +2,17 @@
  * @ai-pip/core - Core implementation of the AI-PIP protocol
  *
  * @remarks
- * Main entry point that re-exports all layers (CSL, ISL, Shared)
+ * Main entry point that re-exports all layers (CSL, ISL, CPE, Shared)
  *
- * You can also import specific layers:
+ * You can import from specific layers:
  * - import { segment } from '@ai-pip/core/csl'
  * - import { sanitize } from '@ai-pip/core/isl'
- * - import { addLineageEntry } from '@ai-pip/core/shared'
  * - import { envelope } from '@ai-pip/core/cpe'
+ *
+ * Or import everything from the main entry point:
+ * - import { addLineageEntry, segment, sanitize, envelope } from '@ai-pip/core'
+ *
+ * Note: Shared functions are only available from the main entry point, not as a subpath.
  */
 // Re-export CSL
 export { segment, classifySource, classifyOrigin, initLineage, createLineageEntry, generateId, splitByContextRules, OriginType, TrustLevelType, ClassificationError, SegmentationError } from './csl';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,gBAAgB;AAChB,OAAO,EACL,OAAO,EACP,cAAc,EACd,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,mBAAmB,EACnB,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,OAAO,CAAA;AAad,gBAAgB;AAChB,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAiBhC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,6BAA6B,EAC7B,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EAClB,MAAM,OAAO,CAAA;AAEd,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,UAAU,CAAA;AAEjB,gBAAgB;AAChB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,wBAAwB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,gBAAgB;AAChB,OAAO,EACL,OAAO,EACP,cAAc,EACd,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,mBAAmB,EACnB,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,OAAO,CAAA;AAad,gBAAgB;AAChB,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAiBhC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,6BAA6B,EAC7B,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EAClB,MAAM,OAAO,CAAA;AAEd,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,UAAU,CAAA;AAEjB,gBAAgB;AAChB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,wBAAwB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-pip/core",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Core implementation of the AI-PIP protocol. Provides layered, zero-trust context processing (CSL, ISL, CPE, ALL, ModelGateway)",
   "type": "module",
   "main": "./dist/index.js",
@@ -34,7 +34,6 @@
   },
   "files": [
     "dist",
-    "src",
     "tsconfig.json",
     "README.md",
     "LICENSE"

package/src/cpe/envelope.ts

@@ -1,115 +0,0 @@
-/**
- * Genera el envoltorio criptográfico (CPEEvelope) - función pura principal de CPE
- * 
- * @remarks
- * Esta es la función principal de CPE. Genera un envoltorio criptográfico
- * que garantiza la integridad y autenticidad del prompt procesado.
- * 
- * **Funciones:**
- * - Genera metadata de seguridad (timestamp, nonce, versión)
- * - Firma criptográficamente el contenido con HMAC-SHA256
- * - Encapsula el contenido sanitizado con metadata
- * - Preserva el linaje completo para auditoría
- * 
- * @param islResult - Resultado de ISL con contenido sanitizado
- * @param secretKey - Clave secreta para HMAC (debe ser proporcionada por el SDK)
- * @returns CPEResult con el envelope criptográfico
- * 
- * @throws {EnvelopeError} Si la generación del envelope falla
- * 
- * @example
- * ```typescript
- * const cpeResult = envelope(islResult, secretKey)
- * 
- * // cpeResult.envelope contiene:
- * // - content: contenido sanitizado serializado
- * // - signature: firma HMAC-SHA256
- * // - metadata: timestamp, nonce, versión
- * // - lineage: linaje completo
- * ```
- */
-import type { ISLResult } from '../isl/types'
-import type { CPEEvelope, CPEResult } from './types'
-import { createNonce } from './value-objects/Nonce'
-import { createMetadata } from './value-objects/Metadata'
-import { createSignature } from './value-objects/Signature'
-import { EnvelopeError } from './exceptions'
-// Serialización NO es core - va al SDK
-// El core solo define la estructura del envelope
-import { addLineageEntries } from '../shared/lineage'
-import { createLineageEntry } from '../csl/value-objects/LineageEntry'
-
-export function envelope(islResult: ISLResult, secretKey: string): CPEResult {
-  const startTime = Date.now()
-
-  try {
-    // 1. Validar input
-    if (!islResult?.segments?.length) {
-      throw new EnvelopeError('ISLResult must contain at least one segment')
-    }
-
-    if (!secretKey || secretKey.length === 0) {
-      throw new EnvelopeError('Secret key is required for envelope generation')
-    }
-
-    // 2. Generar metadata de seguridad
-    const timestamp = Date.now()
-    const nonce = createNonce()
-    const metadata = createMetadata(timestamp, nonce)
-
-    // 3. Preparar payload semántico (contenido procesado por ISL)
-    // El payload puede ser cualquier estructura que represente el contenido procesado
-    const payload: unknown = {
-      segments: islResult.segments.map((segment) => ({
-        id: segment.id,
-        content: segment.sanitizedContent,
-        trust: segment.trust.value,
-        sanitizationLevel: segment.sanitizationLevel,
-      })),
-    }
-
-    // 4. Generar firma criptográfica HMAC-SHA256
-    // Nota: La serialización del contenido para firma debe hacerse en el SDK
-    // El core solo define que se debe firmar el payload + metadata
-    // Por ahora, serializamos de forma básica para mantener funcionalidad
-    
-    const algorithm = 'HMAC-SHA256'
-    const signableContent = JSON.stringify({
-      payload,
-      metadata,
-      algorithm
-    })
-    const signatureVO = createSignature(signableContent, secretKey)
-
-    // 5. Actualizar linaje con entrada CPE
-    const cpeLineageEntry = createLineageEntry('CPE', timestamp)
-    const updatedLineage = addLineageEntries(islResult.lineage, [cpeLineageEntry])
-
-    // 9. Construir envelope según especificación
-    const envelope: CPEEvelope = {
-      payload,
-      metadata,
-      signature: {
-        value: signatureVO.value,
-        algorithm: signatureVO.algorithm,
-      },
-      lineage: updatedLineage,
-    }
-
-    const processingTime = Date.now() - startTime
-
-    return {
-      envelope,
-      processingTimeMs: processingTime,
-    }
-  } catch (error) {
-    if (error instanceof EnvelopeError) {
-      throw error
-    }
-    throw new EnvelopeError(
-      `Failed to generate envelope: ${error instanceof Error ? error.message : 'Unknown error'}`,
-      error instanceof Error ? error : undefined
-    )
-  }
-}
-

package/src/cpe/exceptions/EnvelopeError.ts

@@ -1,11 +0,0 @@
-/**
- * EnvelopeError - Error al generar el envelope criptográfico
- */
-export class EnvelopeError extends Error {
-  constructor(message: string, public readonly cause?: Error) {
-    super(message)
-    this.name = 'EnvelopeError'
-    Object.setPrototypeOf(this, EnvelopeError.prototype)
-  }
-}
-

package/src/cpe/exceptions/index.ts

@@ -1,6 +0,0 @@
-/**
- * CPE Exceptions - Exports
- */
-
-export { EnvelopeError } from './EnvelopeError'
-

package/src/cpe/index.ts

@@ -1,44 +0,0 @@
-/**
- * CPE (Cryptographic Prompt Envelope) - Core Semántico
- * 
- * @remarks
- * Este es el core semántico de CPE. Solo contiene:
- * - Funciones puras (sin estado)
- * - Value objects inmutables
- * - Tipos y excepciones
- * 
- * **Funciones principales:**
- * - Generación de metadata de seguridad (timestamp, nonce, versión)
- * - Firma criptográfica HMAC-SHA256
- * - Construcción del envelope criptográfico
- * - Preservación del linaje completo
- */
-
-// Funciones puras principales
-export { envelope } from './envelope'
-
-// Value objects
-export { createNonce, isValidNonce, equalsNonce } from './value-objects/Nonce'
-export type { Nonce } from './value-objects/Nonce'
-export { createMetadata, isValidMetadata, CURRENT_PROTOCOL_VERSION } from './value-objects/Metadata'
-export { createSignature } from './value-objects/Signature'
-export type { SignatureVO } from './value-objects/Signature'
-
-// Exceptions
-export { EnvelopeError } from './exceptions/EnvelopeError'
-
-// Types
-export type {
-  ProtocolVersion,
-  Timestamp,
-  NonceValue,
-  SignatureAlgorithm,
-  Signature,
-  CPEMetadata,
-  CPEEvelope,
-  CPEResult
-} from './types'
-
-// Serialización y verificación NO son core - van al SDK
-// El core solo define la estructura del envelope, no implementa serialización
-

package/src/cpe/types.ts

@@ -1,68 +0,0 @@
-/**
- * Types for CPE (Cryptographic Prompt Envelope) - Core Semántico
- */
-
-// Importar tipos de CSL
-import type { LineageEntry } from '../csl/value-objects'
-
-/**
- * ProtocolVersion - Versión del protocolo AI-PIP
- */
-export type ProtocolVersion = string
-
-/**
- * Timestamp - Timestamp Unix en milisegundos
- */
-export type Timestamp = number
-
-/**
- * NonceValue - Valor único para prevenir ataques de replay (string)
- */
-export type NonceValue = string
-
-/**
- * SignatureAlgorithm - Algoritmo de firma criptográfica
- */
-export type SignatureAlgorithm = 'HMAC-SHA256'
-
-/**
- * Signature - Firma criptográfica del envelope
- */
-export type Signature = string
-
-/**
- * CPEMetadata - Metadata de seguridad del envelope
- * Según especificación: timestamp, nonce, protocolVersion, previousSignatures opcionales
- */
-export interface CPEMetadata {
-  readonly timestamp: Timestamp
-  readonly nonce: NonceValue
-  readonly protocolVersion: ProtocolVersion
-  readonly previousSignatures?: {
-    readonly csl?: string | undefined
-    readonly isl?: string | undefined
-  } | undefined
-}
-
-/**
- * CPEEvelope - Envoltorio criptográfico completo
- * Según especificación: payload, metadata, signature (value + algorithm), lineage
- */
-export interface CPEEvelope {
-  readonly payload: unknown  // Payload semántico (contenido procesado)
-  readonly metadata: CPEMetadata
-  readonly signature: {
-    readonly value: string
-    readonly algorithm: string
-  }
-  readonly lineage: readonly LineageEntry[]
-}
-
-/**
- * CPEResult - Resultado de la generación del envelope
- */
-export interface CPEResult {
-  readonly envelope: CPEEvelope
-  readonly processingTimeMs?: number
-}
-

package/src/cpe/utils.ts

@@ -1,65 +0,0 @@
-/**
- * Utilidades puras para CPE
- */
-
-/**
- * Serializa el contenido sanitizado de ISL para firma
- * 
- * @param segments - Segmentos sanitizados
- * @returns Contenido serializado
- */
-export function serializeContent(segments: readonly { readonly sanitizedContent: string }[]): string {
-  return segments
-    .map((segment, index) => `[${index}]:${segment.sanitizedContent}`)
-    .join('\n')
-}
-
-/**
- * Serializa metadata para firma
- * 
- * @param metadata - Metadata a serializar
- * @returns Metadata serializada
- */
-export function serializeMetadata(metadata: {
-  readonly timestamp: number
-  readonly nonce: string
-  readonly protocolVersion: string
-  readonly previousSignatures?: {
-    readonly csl?: string | undefined
-    readonly isl?: string | undefined
-  } | undefined
-}): string {
-  const parts = [
-    `timestamp:${metadata.timestamp}`,
-    `nonce:${metadata.nonce}`,
-    `version:${metadata.protocolVersion}`,
-  ]
-
-  if (metadata.previousSignatures?.csl) {
-    parts.push(`csl:${metadata.previousSignatures.csl}`)
-  }
-
-  if (metadata.previousSignatures?.isl) {
-    parts.push(`isl:${metadata.previousSignatures.isl}`)
-  }
-
-  return parts.join('|')
-}
-
-/**
- * Genera el contenido completo para firma
- * Según spec: contenido procesado + metadata + identificador del algoritmo
- * 
- * @param content - Contenido serializado (payload semántico)
- * @param metadata - Metadata serializada
- * @param algorithm - Identificador del algoritmo de firma
- * @returns Contenido completo para firma
- */
-export function generateSignableContent(
-  content: string,
-  metadata: string,
-  algorithm: string
-): string {
-  return `${metadata}\n---\n${content}\n---\nalgorithm:${algorithm}`
-}
-

package/src/cpe/value-objects/Metadata.ts

@@ -1,78 +0,0 @@
-/**
- * CPEMetadata - Metadata de seguridad del envelope
- * Value Object puro e inmutable
- */
-
-import type { CPEMetadata, ProtocolVersion, Timestamp } from '../types'
-import type { Nonce as NonceVO } from './Nonce'
-
-/**
- * Versión actual del protocolo
- */
-export const CURRENT_PROTOCOL_VERSION: ProtocolVersion = '0.1.4'
-
-/**
- * Crea metadata de seguridad para el envelope
- * Según especificación: timestamp, nonce, protocolVersion, previousSignatures opcionales
- * 
- * @param timestamp - Timestamp Unix en milisegundos
- * @param nonce - Nonce único
- * @param protocolVersion - Versión del protocolo (default: CURRENT_PROTOCOL_VERSION)
- * @param previousSignatures - Firmas opcionales de capas anteriores (csl, isl)
- * @returns CPEMetadata inmutable
- */
-export function createMetadata(
-  timestamp: Timestamp,
-  nonce: NonceVO,
-  protocolVersion: ProtocolVersion = CURRENT_PROTOCOL_VERSION,
-  previousSignatures?: {
-    csl?: string
-    isl?: string
-  }
-): CPEMetadata {
-  // Validar timestamp
-  if (timestamp <= 0) {
-    throw new Error('Timestamp must be a positive number')
-  }
-
-  // Validar que no sea del futuro (con margen de 5 minutos para sincronización)
-  const maxFutureTimestamp = Date.now() + 5 * 60 * 1000
-  if (timestamp > maxFutureTimestamp) {
-    throw new Error('Timestamp cannot be in the future')
-  }
-
-  // Validar version del protocolo
-  if (!protocolVersion || typeof protocolVersion !== 'string') {
-    throw new Error('Protocol version must be a non-empty string')
-  }
-
-  return Object.freeze({
-    timestamp,
-    nonce: nonce.value,
-    protocolVersion,
-    previousSignatures: previousSignatures
-      ? Object.freeze({
-          csl: previousSignatures.csl ?? undefined,
-          isl: previousSignatures.isl ?? undefined,
-        })
-      : undefined,
-  })
-}
-
-/**
- * Valida que la metadata sea válida
- * 
- * @param metadata - Metadata a validar
- * @returns true si es válida
- */
-export function isValidMetadata(metadata: CPEMetadata): boolean {
-  try {
-    if (metadata.timestamp <= 0) return false
-    if (!metadata.nonce || metadata.nonce.length < 16) return false
-    if (!metadata.protocolVersion) return false
-    return true
-  } catch {
-    return false
-  }
-}
-