comisai 1.0.19 → 1.0.23

package/node_modules/@comis/core/dist/config/schema-delivery-mirror.d.ts

@@ -1,27 +0,0 @@
-/**
- * Delivery mirror configuration schema.
- *
- * Defines settings for the session mirroring persistence layer:
- * enable/disable, retention, pruning, and injection limits.
- *
- * Phase 502: Session Mirroring.
- */
-import { z } from "zod";
-/**
- * DeliveryMirrorConfigSchema -- validated configuration for the delivery mirror.
- *
- * All fields have sensible defaults so an empty object produces a valid config.
- */
-export declare const DeliveryMirrorConfigSchema: z.ZodObject<{
-    /** Whether the delivery mirror is enabled. When false, no entries are recorded. */
-    enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Maximum age in milliseconds before mirror entries are pruned (24 hours). */
-    retentionMs: z.ZodDefault<z.ZodNumber>;
-    /** Interval in milliseconds between automatic prune sweeps (5 minutes). */
-    pruneIntervalMs: z.ZodDefault<z.ZodNumber>;
-    /** Maximum number of mirror entries injected per prompt turn. */
-    maxEntriesPerInjection: z.ZodDefault<z.ZodNumber>;
-    /** Maximum total characters of mirror text injected per prompt turn. */
-    maxCharsPerInjection: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strict>;
-export type DeliveryMirrorConfig = z.infer<typeof DeliveryMirrorConfigSchema>;

package/node_modules/@comis/core/dist/config/schema-delivery-mirror.js

@@ -1,26 +0,0 @@
-/**
- * Delivery mirror configuration schema.
- *
- * Defines settings for the session mirroring persistence layer:
- * enable/disable, retention, pruning, and injection limits.
- *
- * Phase 502: Session Mirroring.
- */
-import { z } from "zod";
-/**
- * DeliveryMirrorConfigSchema -- validated configuration for the delivery mirror.
- *
- * All fields have sensible defaults so an empty object produces a valid config.
- */
-export const DeliveryMirrorConfigSchema = z.strictObject({
-    /** Whether the delivery mirror is enabled. When false, no entries are recorded. */
-    enabled: z.boolean().default(true),
-    /** Maximum age in milliseconds before mirror entries are pruned (24 hours). */
-    retentionMs: z.number().int().positive().default(86_400_000),
-    /** Interval in milliseconds between automatic prune sweeps (5 minutes). */
-    pruneIntervalMs: z.number().int().positive().default(300_000),
-    /** Maximum number of mirror entries injected per prompt turn. */
-    maxEntriesPerInjection: z.number().int().positive().default(10),
-    /** Maximum total characters of mirror text injected per prompt turn. */
-    maxCharsPerInjection: z.number().int().positive().default(4000),
-});

package/node_modules/@comis/core/dist/config/schema-delivery-queue.d.ts

@@ -1,31 +0,0 @@
-/**
- * Delivery queue configuration schema.
- *
- * Defines settings for the crash-safe outbound delivery queue:
- * enable/disable, depth limits, retry policy, drain behavior, and pruning.
- *
- * Phase 499: Crash-Safe Delivery Queue.
- */
-import { z } from "zod";
-/**
- * DeliveryQueueConfigSchema -- validated configuration for the delivery queue.
- *
- * All fields have sensible defaults so an empty object produces a valid config.
- */
-export declare const DeliveryQueueConfigSchema: z.ZodObject<{
-    /** Whether the delivery queue is enabled. When false, messages bypass persistence. */
-    enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Maximum number of entries allowed in the queue. Enqueue rejects when full. */
-    maxQueueDepth: z.ZodDefault<z.ZodNumber>;
-    /** Default maximum delivery attempts before marking an entry as failed. */
-    defaultMaxAttempts: z.ZodDefault<z.ZodNumber>;
-    /** Default time-to-live in milliseconds before an entry expires (1 hour). */
-    defaultExpireMs: z.ZodDefault<z.ZodNumber>;
-    /** Whether to drain pending entries on daemon startup (crash recovery). */
-    drainOnStartup: z.ZodDefault<z.ZodBoolean>;
-    /** Maximum time in milliseconds allowed for startup drain before continuing. */
-    drainBudgetMs: z.ZodDefault<z.ZodNumber>;
-    /** Interval in milliseconds between automatic prune sweeps for expired entries. */
-    pruneIntervalMs: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strict>;
-export type DeliveryQueueConfig = z.infer<typeof DeliveryQueueConfigSchema>;

package/node_modules/@comis/core/dist/config/schema-delivery-queue.js

@@ -1,30 +0,0 @@
-/**
- * Delivery queue configuration schema.
- *
- * Defines settings for the crash-safe outbound delivery queue:
- * enable/disable, depth limits, retry policy, drain behavior, and pruning.
- *
- * Phase 499: Crash-Safe Delivery Queue.
- */
-import { z } from "zod";
-/**
- * DeliveryQueueConfigSchema -- validated configuration for the delivery queue.
- *
- * All fields have sensible defaults so an empty object produces a valid config.
- */
-export const DeliveryQueueConfigSchema = z.strictObject({
-    /** Whether the delivery queue is enabled. When false, messages bypass persistence. */
-    enabled: z.boolean().default(true),
-    /** Maximum number of entries allowed in the queue. Enqueue rejects when full. */
-    maxQueueDepth: z.number().int().positive().default(10_000),
-    /** Default maximum delivery attempts before marking an entry as failed. */
-    defaultMaxAttempts: z.number().int().positive().default(5),
-    /** Default time-to-live in milliseconds before an entry expires (1 hour). */
-    defaultExpireMs: z.number().int().positive().default(3_600_000),
-    /** Whether to drain pending entries on daemon startup (crash recovery). */
-    drainOnStartup: z.boolean().default(true),
-    /** Maximum time in milliseconds allowed for startup drain before continuing. */
-    drainBudgetMs: z.number().int().positive().default(60_000),
-    /** Interval in milliseconds between automatic prune sweeps for expired entries. */
-    pruneIntervalMs: z.number().int().positive().default(300_000),
-});

package/node_modules/@comis/core/dist/config/schema-delivery-timing.d.ts

@@ -1,41 +0,0 @@
-import { z } from "zod";
-/**
- * Delivery timing mode determines how inter-block delays are calculated.
- *
- * - `off`: No delay between blocks (instant delivery)
- * - `natural`: Human-like typing delay based on block length
- * - `custom`: Fixed delay range (minMs..maxMs + jitter)
- * - `adaptive`: Adjusts delay based on conversation pace and block complexity
- */
-export declare const DeliveryTimingModeSchema: z.ZodDefault<z.ZodEnum<{
-    off: "off";
-    custom: "custom";
-    natural: "natural";
-    adaptive: "adaptive";
-}>>;
-/**
- * Delivery timing configuration schema.
- *
- * Controls the pacing of block-by-block message delivery to simulate
- * natural typing rhythm. Applies after the coalescer flushes a block
- * and before the channel adapter sends it.
- */
-export declare const DeliveryTimingConfigSchema: z.ZodObject<{
-    /** Timing mode: off, natural, custom, or adaptive */
-    mode: z.ZodDefault<z.ZodEnum<{
-        off: "off";
-        custom: "custom";
-        natural: "natural";
-        adaptive: "adaptive";
-    }>>;
-    /** Minimum delay (ms) between block deliveries */
-    minMs: z.ZodDefault<z.ZodNumber>;
-    /** Maximum delay (ms) between block deliveries */
-    maxMs: z.ZodDefault<z.ZodNumber>;
-    /** Random jitter (ms) added to each delay for natural feel */
-    jitterMs: z.ZodDefault<z.ZodNumber>;
-    /** Extra delay (ms) before delivering the first block of a response */
-    firstBlockDelayMs: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strict>;
-export type DeliveryTimingConfig = z.infer<typeof DeliveryTimingConfigSchema>;
-export type DeliveryTimingMode = z.infer<typeof DeliveryTimingModeSchema>;

package/node_modules/@comis/core/dist/config/schema-delivery-timing.js

@@ -1,31 +0,0 @@
-import { z } from "zod";
-/**
- * Delivery timing mode determines how inter-block delays are calculated.
- *
- * - `off`: No delay between blocks (instant delivery)
- * - `natural`: Human-like typing delay based on block length
- * - `custom`: Fixed delay range (minMs..maxMs + jitter)
- * - `adaptive`: Adjusts delay based on conversation pace and block complexity
- */
-export const DeliveryTimingModeSchema = z
-    .enum(["off", "natural", "custom", "adaptive"])
-    .default("natural");
-/**
- * Delivery timing configuration schema.
- *
- * Controls the pacing of block-by-block message delivery to simulate
- * natural typing rhythm. Applies after the coalescer flushes a block
- * and before the channel adapter sends it.
- */
-export const DeliveryTimingConfigSchema = z.strictObject({
-    /** Timing mode: off, natural, custom, or adaptive */
-    mode: DeliveryTimingModeSchema,
-    /** Minimum delay (ms) between block deliveries */
-    minMs: z.number().int().nonnegative().default(800),
-    /** Maximum delay (ms) between block deliveries */
-    maxMs: z.number().int().nonnegative().default(2500),
-    /** Random jitter (ms) added to each delay for natural feel */
-    jitterMs: z.number().int().nonnegative().default(200),
-    /** Extra delay (ms) before delivering the first block of a response */
-    firstBlockDelayMs: z.number().int().nonnegative().default(0),
-});

package/node_modules/@comis/core/dist/config/schema-monitoring.d.ts

@@ -1,105 +0,0 @@
-import { z } from "zod";
-/**
- * Monitoring configuration schemas.
- *
- * Defines thresholds and settings for system monitoring heartbeat sources:
- * disk space, CPU/memory resources, systemd services, security updates,
- * and git repository watching.
- *
- * MON-01: Disk space monitoring
- * MON-02: Resource utilization monitoring
- * MON-03: Service health monitoring
- * MON-04: Security update and git repo monitoring
- */
-declare const DiskMonitorSchema: z.ZodObject<{
-    /** Whether disk space monitoring is enabled. */
-    enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Filesystem paths to monitor. */
-    paths: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    /** Alert when usage exceeds this percentage. */
-    thresholdPercent: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strict>;
-declare const ResourceMonitorSchema: z.ZodObject<{
-    /** Whether CPU/memory monitoring is enabled. */
-    enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Alert when CPU usage exceeds this percentage. */
-    cpuThresholdPercent: z.ZodDefault<z.ZodNumber>;
-    /** Alert when memory usage exceeds this percentage. */
-    memoryThresholdPercent: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strict>;
-declare const SystemdMonitorSchema: z.ZodObject<{
-    /** Whether systemd service monitoring is enabled. */
-    enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Specific services to monitor (empty = check all failed). */
-    services: z.ZodDefault<z.ZodArray<z.ZodString>>;
-}, z.core.$strict>;
-declare const SecurityUpdateMonitorSchema: z.ZodObject<{
-    /** Whether security update monitoring is enabled. */
-    enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Only check for security updates (not all updates). */
-    securityOnly: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strict>;
-declare const GitMonitorSchema: z.ZodObject<{
-    /** Whether git repository monitoring is enabled (default: off). */
-    enabled: z.ZodDefault<z.ZodBoolean>;
-    /** Absolute paths to git repositories to monitor. */
-    repositories: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    /** Check remote for unpushed commits. */
-    checkRemote: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strict>;
-/**
- * Root monitoring configuration schema.
- *
- * Each sub-section has sensible defaults so an empty object
- * produces a valid MonitoringConfig.
- */
-export declare const MonitoringConfigSchema: z.ZodObject<{
-    /** Disk space monitoring. */
-    disk: z.ZodDefault<z.ZodObject<{
-        /** Whether disk space monitoring is enabled. */
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Filesystem paths to monitor. */
-        paths: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        /** Alert when usage exceeds this percentage. */
-        thresholdPercent: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strict>>;
-    /** CPU and memory monitoring. */
-    resources: z.ZodDefault<z.ZodObject<{
-        /** Whether CPU/memory monitoring is enabled. */
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Alert when CPU usage exceeds this percentage. */
-        cpuThresholdPercent: z.ZodDefault<z.ZodNumber>;
-        /** Alert when memory usage exceeds this percentage. */
-        memoryThresholdPercent: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strict>>;
-    /** systemd service health monitoring. */
-    systemd: z.ZodDefault<z.ZodObject<{
-        /** Whether systemd service monitoring is enabled. */
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Specific services to monitor (empty = check all failed). */
-        services: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    }, z.core.$strict>>;
-    /** Security update monitoring. */
-    securityUpdates: z.ZodDefault<z.ZodObject<{
-        /** Whether security update monitoring is enabled. */
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Only check for security updates (not all updates). */
-        securityOnly: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strict>>;
-    /** Git repository monitoring. */
-    git: z.ZodDefault<z.ZodObject<{
-        /** Whether git repository monitoring is enabled (default: off). */
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        /** Absolute paths to git repositories to monitor. */
-        repositories: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        /** Check remote for unpushed commits. */
-        checkRemote: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strict>>;
-}, z.core.$strict>;
-export type MonitoringConfig = z.infer<typeof MonitoringConfigSchema>;
-export type DiskMonitorConfig = z.infer<typeof DiskMonitorSchema>;
-export type ResourceMonitorConfig = z.infer<typeof ResourceMonitorSchema>;
-export type SystemdMonitorConfig = z.infer<typeof SystemdMonitorSchema>;
-export type SecurityUpdateMonitorConfig = z.infer<typeof SecurityUpdateMonitorSchema>;
-export type GitMonitorConfig = z.infer<typeof GitMonitorSchema>;
-export {};

package/node_modules/@comis/core/dist/config/schema-monitoring.js

@@ -1,67 +0,0 @@
-import { z } from "zod";
-/**
- * Monitoring configuration schemas.
- *
- * Defines thresholds and settings for system monitoring heartbeat sources:
- * disk space, CPU/memory resources, systemd services, security updates,
- * and git repository watching.
- *
- * MON-01: Disk space monitoring
- * MON-02: Resource utilization monitoring
- * MON-03: Service health monitoring
- * MON-04: Security update and git repo monitoring
- */
-const DiskMonitorSchema = z.strictObject({
-    /** Whether disk space monitoring is enabled. */
-    enabled: z.boolean().default(true),
-    /** Filesystem paths to monitor. */
-    paths: z.array(z.string()).default(["/"]),
-    /** Alert when usage exceeds this percentage. */
-    thresholdPercent: z.number().min(0).max(100).default(90),
-});
-const ResourceMonitorSchema = z.strictObject({
-    /** Whether CPU/memory monitoring is enabled. */
-    enabled: z.boolean().default(true),
-    /** Alert when CPU usage exceeds this percentage. */
-    cpuThresholdPercent: z.number().min(0).max(100).default(85),
-    /** Alert when memory usage exceeds this percentage. */
-    memoryThresholdPercent: z.number().min(0).max(100).default(90),
-});
-const SystemdMonitorSchema = z.strictObject({
-    /** Whether systemd service monitoring is enabled. */
-    enabled: z.boolean().default(true),
-    /** Specific services to monitor (empty = check all failed). */
-    services: z.array(z.string()).default([]),
-});
-const SecurityUpdateMonitorSchema = z.strictObject({
-    /** Whether security update monitoring is enabled. */
-    enabled: z.boolean().default(true),
-    /** Only check for security updates (not all updates). */
-    securityOnly: z.boolean().default(true),
-});
-const GitMonitorSchema = z.strictObject({
-    /** Whether git repository monitoring is enabled (default: off). */
-    enabled: z.boolean().default(false),
-    /** Absolute paths to git repositories to monitor. */
-    repositories: z.array(z.string()).default([]),
-    /** Check remote for unpushed commits. */
-    checkRemote: z.boolean().default(true),
-});
-/**
- * Root monitoring configuration schema.
- *
- * Each sub-section has sensible defaults so an empty object
- * produces a valid MonitoringConfig.
- */
-export const MonitoringConfigSchema = z.strictObject({
-    /** Disk space monitoring. */
-    disk: DiskMonitorSchema.default(() => DiskMonitorSchema.parse({})),
-    /** CPU and memory monitoring. */
-    resources: ResourceMonitorSchema.default(() => ResourceMonitorSchema.parse({})),
-    /** systemd service health monitoring. */
-    systemd: SystemdMonitorSchema.default(() => SystemdMonitorSchema.parse({})),
-    /** Security update monitoring. */
-    securityUpdates: SecurityUpdateMonitorSchema.default(() => SecurityUpdateMonitorSchema.parse({})),
-    /** Git repository monitoring. */
-    git: GitMonitorSchema.default(() => GitMonitorSchema.parse({})),
-});

package/node_modules/@comis/core/dist/ports/media-ports.d.ts

@@ -1,278 +0,0 @@
-import type { Result } from "@comis/shared";
-import type { Attachment } from "../domain/normalized-message.js";
-/**
- * Options for audio transcription.
- */
-export interface TranscriptionOptions {
-    /** MIME type of the audio buffer (e.g. "audio/ogg", "audio/mp3") */
-    readonly mimeType: string;
-    /** BCP-47 language hint (e.g. "en", "es"). Provider may auto-detect if omitted. */
-    readonly language?: string;
-    /** Optional prompt/context to guide transcription accuracy. */
-    readonly prompt?: string;
-}
-/**
- * Result of a successful transcription.
- */
-export interface TranscriptionResult {
-    /** Transcribed text. */
-    readonly text: string;
-    /** Detected or confirmed language (BCP-47). */
-    readonly language?: string;
-    /** Duration of the audio in milliseconds. */
-    readonly durationMs?: number;
-}
-/**
- * TranscriptionPort: Hexagonal boundary for speech-to-text services.
- *
- * Adapters (OpenAI Whisper, local whisper.cpp, etc.) implement this
- * interface to convert audio buffers into text.
- */
-export interface TranscriptionPort {
-    /**
-     * Transcribe an audio buffer to text.
-     *
-     * @param audio - Raw audio data
-     * @param options - MIME type, language hint, optional prompt
-     * @returns Transcription result or an error (e.g. file too large, API failure)
-     */
-    transcribe(audio: Buffer, options: TranscriptionOptions): Promise<Result<TranscriptionResult, Error>>;
-}
-/**
- * Options for text-to-speech synthesis.
- */
-export interface TTSOptions {
-    /** Voice identifier (provider-specific, e.g. "alloy", "nova"). */
-    readonly voice?: string;
-    /** Output audio format (e.g. "mp3", "opus", "aac", "flac"). */
-    readonly format?: string;
-    /** Playback speed multiplier (0.25 to 4.0). */
-    readonly speed?: number;
-}
-/**
- * Result of a successful TTS synthesis.
- */
-export interface TTSResult {
-    /** Raw audio data. */
-    readonly audio: Buffer;
-    /** MIME type of the audio (e.g. "audio/mpeg", "audio/opus"). */
-    readonly mimeType: string;
-}
-/**
- * TTSPort: Hexagonal boundary for text-to-speech services.
- *
- * Adapters (OpenAI TTS, ElevenLabs, local Piper, etc.) implement this
- * interface to synthesize audio from text.
- */
-export interface TTSPort {
-    /**
-     * Synthesize text into audio.
-     *
-     * @param text - Text content to convert to speech
-     * @param options - Voice, format, and speed configuration
-     * @returns Audio buffer with MIME type, or an error
-     */
-    synthesize(text: string, options?: TTSOptions): Promise<Result<TTSResult, Error>>;
-}
-/**
- * Options for image analysis.
- */
-export interface ImageAnalysisOptions {
-    /** MIME type of the image buffer (e.g. "image/png", "image/jpeg"). */
-    readonly mimeType: string;
-    /** Maximum tokens in the analysis response. */
-    readonly maxTokens?: number;
-}
-/**
- * ImageAnalysisPort: Hexagonal boundary for multimodal image analysis.
- *
- * Adapters (Anthropic Claude, OpenAI GPT-4o, etc.) implement this
- * interface to analyze images using vision-capable LLMs.
- */
-export interface ImageAnalysisPort {
-    /**
-     * Analyze an image given a prompt.
-     *
-     * @param image - Raw image data
-     * @param prompt - Question or instruction about the image
-     * @param options - MIME type and response length configuration
-     * @returns Analysis text or an error (e.g. file too large, unsupported format)
-     */
-    analyze(image: Buffer, prompt: string, options: ImageAnalysisOptions): Promise<Result<string, Error>>;
-}
-/**
- * Request payload for image vision analysis.
- */
-export interface VisionRequest {
-    /** Raw image data. */
-    readonly image: Buffer;
-    /** Question or instruction about the image. */
-    readonly prompt: string;
-    /** MIME type of the image (e.g. "image/png", "image/jpeg"). */
-    readonly mimeType: string;
-    /** Maximum tokens in the response. */
-    readonly maxTokens?: number;
-}
-/**
- * Request payload for video vision analysis.
- */
-export interface VideoRequest {
-    /** Raw video data. */
-    readonly video: Buffer;
-    /** Question or instruction about the video. */
-    readonly prompt: string;
-    /** MIME type of the video (e.g. "video/mp4", "video/webm"). */
-    readonly mimeType: string;
-    /** Maximum tokens in the response. */
-    readonly maxTokens?: number;
-}
-/**
- * Result of a vision analysis (image or video).
- */
-export interface VisionResult {
-    /** Analysis text. */
-    readonly text: string;
-    /** Provider that produced the result (e.g. "openai", "anthropic", "google"). */
-    readonly provider: string;
-    /** Model used for analysis. */
-    readonly model: string;
-    /** Tokens used (if available from the provider). */
-    readonly tokensUsed?: number;
-}
-/**
- * VisionProvider: Multi-capability vision analysis provider.
- *
- * Each provider declares which media types it supports (image, video, or both).
- * The registry uses capabilities to route requests to the right provider.
- */
-export interface VisionProvider {
-    /** Unique provider identifier (e.g. "openai", "anthropic", "google"). */
-    readonly id: string;
-    /** Media types this provider can analyze. */
-    readonly capabilities: ReadonlyArray<"image" | "video">;
-    /** Analyze an image. */
-    describeImage(req: VisionRequest): Promise<Result<VisionResult, Error>>;
-    /** Analyze a video (optional — only providers with "video" capability). */
-    describeVideo?(req: VideoRequest): Promise<Result<VisionResult, Error>>;
-}
-/**
- * Result of resolving a media attachment to a buffer.
- */
-export interface ResolvedMedia {
-    /** Downloaded file content. */
-    readonly buffer: Buffer;
-    /** Verified MIME type (sniffed, not declared). */
-    readonly mimeType: string;
-    /** File size in bytes. */
-    readonly sizeBytes: number;
-}
-/**
- * MediaResolverPort: Hexagonal boundary for media resolution.
- *
- * Per-platform adapters implement this interface to download attachments
- * from platform-specific URLs (e.g., tg-file:// for Telegram, https://
- * for public URLs). The resolver registry routes to the correct adapter
- * based on the URI scheme.
- */
-export interface MediaResolverPort {
-    /** URI schemes this resolver handles (e.g., ["tg-file", "https"]). */
-    readonly schemes: ReadonlyArray<string>;
-    /**
-     * Resolve an attachment URL to a downloaded buffer.
-     *
-     * Implementations MUST validate URLs through validateUrl() from
-     * @comis/core/security before any HTTP request to prevent SSRF.
-     * Private, loopback, link-local, and cloud-metadata IPs are blocked.
-     * DNS rebinding protection is mandatory: resolve hostname to IP,
-     * check blocklist, then connect using pinned IP.
-     *
-     * Implementations MUST check Content-Length against the configured
-     * maxRemoteFetchBytes limit and abort before streaming the body
-     * if exceeded.
-     *
-     * @param attachment - The attachment to resolve
-     * @returns Resolved media buffer with MIME type and size, or an error
-     */
-    resolve(attachment: Attachment): Promise<Result<ResolvedMedia, Error>>;
-}
-/**
- * Classification of a file based on its MIME type.
- *
- * - `"document"`: Extractable text content in the MIME whitelist (PDF, plain text, CSV, etc.)
- * - `"binary"`: Known binary format (images, audio, video, archives) — not text-extractable
- * - `"unknown"`: Unrecognized MIME type — classification cannot be determined
- */
-export type FileClassification = "document" | "binary" | "unknown";
-/**
- * Error categories for file extraction failures.
- */
-export type FileExtractionErrorKind = "timeout" | "encrypted" | "size_exceeded" | "unsupported_mime" | "encoding_error" | "corrupt" | "download_failed" | "internal";
-/**
- * Structured error returned by FileExtractionPort on failure.
- */
-export interface FileExtractionError {
-    readonly kind: FileExtractionErrorKind;
-    readonly message: string;
-    readonly mimeType?: string;
-    readonly fileName?: string;
-}
-/**
- * Input for file extraction. Discriminated union on the `source` field.
- *
- * - `"buffer"`: Extract from an in-memory buffer (mimeType required).
- * - `"url"`: Extract from a remote URL (mimeType optional, may need detection).
- */
-export type FileExtractionInput = {
-    readonly source: "buffer";
-    readonly buffer: Buffer;
-    readonly mimeType: string;
-    readonly fileName?: string;
-    readonly sizeBytes?: number;
-} | {
-    readonly source: "url";
-    readonly url: string;
-    readonly mimeType?: string;
-    readonly fileName?: string;
-    readonly sizeBytes?: number;
-};
-/**
- * Result of a successful file extraction.
- */
-export interface FileExtractionResult {
-    /** Extracted text content. */
-    readonly text: string;
-    /** File name (original or detected). */
-    readonly fileName: string;
-    /** MIME type of the source file. */
-    readonly mimeType: string;
-    /** Number of characters in the extracted text. */
-    readonly extractedChars: number;
-    /** Whether the text was truncated to fit maxChars. */
-    readonly truncated: boolean;
-    /** Time taken for extraction in milliseconds. */
-    readonly durationMs: number;
-    /** Original file buffer for downstream re-use. */
-    readonly buffer: Buffer;
-    /** Number of pages extracted (for paginated formats like PDF). */
-    readonly pageCount?: number;
-    /** Total pages in the document (may differ from pageCount if maxPages limit applied). */
-    readonly totalPages?: number;
-}
-/**
- * FileExtractionPort: Hexagonal boundary for document text extraction services.
- *
- * Adapters implement this interface to extract text content from document files
- * (PDF, plain text, CSV, etc.). The port accepts both in-memory buffers and
- * remote URLs as input sources.
- */
-export interface FileExtractionPort {
-    /**
-     * Extract text content from a document file.
-     *
-     * @param input - File source (buffer or URL) with metadata
-     * @returns Extraction result with text and metrics, or a structured error
-     */
-    extract(input: FileExtractionInput): Promise<Result<FileExtractionResult, FileExtractionError>>;
-    /** MIME types this adapter can extract text from. */
-    readonly supportedMimes: ReadonlyArray<string>;
-}

package/node_modules/@comis/core/dist/ports/media-ports.js

@@ -1 +0,0 @@
-export {};