@hermespilot/link 0.1.9 → 0.2.0

package/dist/http/app.d.ts

@@ -15,6 +15,42 @@ interface RuntimePaths {
     pairingDir: string;
 }
 
+interface LinkStatistics {
+    conversations: {
+        total: number;
+        active: number;
+        deleted: number;
+    };
+    tokens: {
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+    };
+    messages: {
+        total: number;
+    };
+    runs: {
+        total: number;
+    };
+    models: {
+        total: number;
+    };
+    profiles: {
+        total: number;
+    };
+    skills: {
+        total: number;
+    };
+    tools: {
+        total: number;
+    };
+    updated_at?: string;
+}
+interface LinkStatisticsFilter {
+    profileUid?: string | null;
+    profileName?: string | null;
+}
+
 type LogLevel = 'debug' | 'info' | 'warn' | 'error';
 interface FileLoggerOptions {
     paths?: RuntimePaths;
@@ -41,9 +77,315 @@ declare class FileLogger {
     private rotateIfNeeded;
 }
 
+interface ConversationProfileSummary {
+    uid?: string;
+    name: string;
+    display_name: string;
+    avatar_url?: string | null;
+}
+interface ConversationSummary {
+    id: string;
+    title: string;
+    created_at: string;
+    updated_at: string;
+    last_event_seq: number;
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+        updated_at?: string;
+    };
+    profile: ConversationProfileSummary;
+    last_message: {
+        id: string;
+        role: string;
+        content_preview: string;
+    } | null;
+}
+interface ConversationRuntimeMetadata {
+    profile: ConversationProfileSummary;
+    model: {
+        id: string;
+        provider?: string;
+        context_window?: number;
+        reasoning_effort?: string;
+    };
+    context: {
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+        context_window?: number;
+        usage_percent?: number;
+        updated_at?: string;
+    };
+}
+interface ConversationMessagesPageInfo {
+    limit: number;
+    has_more_before: boolean;
+    has_more_after: boolean;
+    oldest_message_id: string | null;
+    newest_message_id: string | null;
+}
+interface LinkMessagePart {
+    type: 'text' | 'image' | 'file' | 'audio' | 'video' | 'unsupported';
+    text?: string;
+    blob?: string;
+    mime?: string;
+    size?: number;
+    filename?: string;
+    url?: string;
+    local_path?: string;
+    kind?: 'voice';
+    is_voice_note?: boolean;
+    duration_ms?: number;
+    waveform?: number[];
+}
+interface LinkMessageAgentEvent {
+    id: string;
+    title: string;
+    status: 'running' | 'completed' | 'failed' | 'info';
+    created_at: string;
+    subtitle?: string;
+    detail?: string;
+    completed_at?: string;
+    raw?: {
+        format: string;
+        payload: unknown;
+    };
+}
+interface LinkMessage {
+    id: string;
+    schema_version: 1;
+    conversation_id: string;
+    role: 'user' | 'assistant' | 'tool' | 'system';
+    status: 'queued' | 'completed' | 'streaming' | 'failed' | 'cancelled';
+    run_id?: string;
+    client_message_id?: string;
+    created_at: string;
+    updated_at: string;
+    sender: {
+        id: string;
+        type: 'human' | 'agent' | 'system' | 'tool';
+        display_name: string;
+        profile_uid?: string;
+        profile?: string;
+    };
+    parts: LinkMessagePart[];
+    attachments: unknown[];
+    agent_events?: LinkMessageAgentEvent[];
+    hermes?: Record<string, unknown>;
+    raw?: {
+        format: string;
+        payload: unknown;
+    };
+}
+interface ConversationEvent {
+    seq: number;
+    type: string;
+    conversation_id: string;
+    message_id?: string;
+    run_id?: string;
+    created_at: string;
+    payload?: Record<string, unknown>;
+    raw?: {
+        format: string;
+        payload: unknown;
+    };
+}
+interface DeleteConversationResult {
+    conversation_id: string;
+    hermes_deleted: boolean;
+    deleted_at: string;
+}
+interface BulkDeleteConversationResult {
+    conversation_id: string;
+    status: 'deleted' | 'failed';
+    hermes_deleted?: boolean;
+    deleted_at?: string;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+interface LinkRun {
+    id: string;
+    kind?: 'agent' | 'command';
+    hermes_run_id?: string;
+    conversation_id: string;
+    trigger_message_id: string;
+    assistant_message_id: string;
+    hermes_session_id: string;
+    status: 'queued' | 'running' | 'completed' | 'failed' | 'cancelled' | 'unknown';
+    started_at: string;
+    completed_at?: string;
+    error_message?: string;
+    error_detail?: string;
+    profile_uid?: string;
+    profile_name_snapshot?: string;
+    profile?: string;
+    model?: string;
+    provider?: string;
+    context_window?: number;
+    usage?: {
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+        context_tokens?: number;
+        context_window?: number;
+        usage_percent?: number;
+    };
+}
+interface SendMessageInput {
+    conversationId: string;
+    content: string;
+    attachments?: MessageAttachmentInput[];
+    clientMessageId?: string;
+    idempotencyKey?: string;
+    profileName?: string;
+}
+interface MessageAttachmentInput {
+    blob_id?: string;
+    blobId?: string;
+    kind?: string;
+    type?: string;
+    is_voice_note?: boolean;
+    isVoiceNote?: boolean;
+    duration_ms?: number;
+    durationMs?: number;
+    waveform?: number[];
+    waveform_samples?: number[];
+    waveformSamples?: number[];
+}
+interface ConversationMessagesPageOptions {
+    limit?: number;
+    beforeMessageId?: string;
+}
+interface SendMessageResult {
+    conversation_id: string;
+    user_message: Pick<LinkMessage, 'id' | 'status'>;
+    assistant_message: Pick<LinkMessage, 'id' | 'status'>;
+    run: Pick<LinkRun, 'id' | 'status'>;
+    last_event_seq: number;
+    conversation?: ConversationSummary;
+}
+interface CancelRunResult {
+    conversation_id: string;
+    run: Pick<LinkRun, 'id' | 'status'>;
+    last_event_seq: number;
+}
+type ConversationEventListener = (event: ConversationEvent) => void;
+
+declare class ConversationService {
+    private readonly paths;
+    private readonly logger;
+    private readonly emitter;
+    private readonly conversationLocks;
+    private readonly activeRunControllers;
+    private readonly store;
+    private readonly commandHandlers;
+    private readonly metadata;
+    private readonly maintenance;
+    private readonly orchestration;
+    private readonly queries;
+    private readonly runLifecycle;
+    constructor(paths: RuntimePaths, logger: FileLogger);
+    private withConversationLock;
+    listConversations(): Promise<ConversationSummary[]>;
+    getStatistics(filter?: LinkStatisticsFilter): Promise<LinkStatistics>;
+    rebuildStatisticsIndex(): Promise<void>;
+    createConversation(input?: {
+        title?: string;
+        profileName?: string;
+    }): Promise<ConversationSummary>;
+    ensureCronInboxConversation(input?: {
+        profileName?: string;
+    }): Promise<string>;
+    appendCronDelivery(input: {
+        conversationId: string;
+        profileName: string;
+        jobId: string;
+        jobName?: string;
+        outputPath: string;
+        content: string;
+        runAt?: string;
+    }): Promise<void>;
+    syncCronDeliveries(): Promise<void>;
+    getMessages(conversationId: string, options?: ConversationMessagesPageOptions): Promise<{
+        messages: LinkMessage[];
+        last_event_seq: number;
+        runtime: ConversationRuntimeMetadata;
+        page: ConversationMessagesPageInfo;
+    }>;
+    setConversationModel(conversationId: string, modelId: string): Promise<{
+        conversation_id: string;
+        model_override: string;
+        runtime: ConversationRuntimeMetadata;
+        last_event_seq: number;
+    }>;
+    setConversationProfile(conversationId: string, profileName: string): Promise<{
+        conversation_id: string;
+        profile: {
+            uid: string;
+            name: string;
+            display_name: string;
+            avatar_url: string | null;
+        };
+        runtime: ConversationRuntimeMetadata;
+        conversation: ConversationSummary;
+        last_event_seq: number;
+    }>;
+    listEvents(conversationId: string, after?: number): Promise<ConversationEvent[]>;
+    subscribe(conversationId: string, listener: ConversationEventListener): () => void;
+    subscribeAll(listener: ConversationEventListener): () => void;
+    sendMessage(input: SendMessageInput): Promise<SendMessageResult>;
+    cancelRun(conversationId: string, runId: string): Promise<CancelRunResult>;
+    cancelRunById(runId: string): Promise<CancelRunResult>;
+    deleteConversation(conversationId: string): Promise<DeleteConversationResult>;
+    deleteConversations(conversationIds: string[]): Promise<{
+        deleted_count: number;
+        failed_count: number;
+        conversations: BulkDeleteConversationResult[];
+    }>;
+    deleteLocalConversationsForProfile(input: {
+        profileName: string;
+        profileUid?: string | null;
+    }): Promise<{
+        deleted_count: number;
+        conversation_ids: string[];
+    }>;
+    writeBlob(conversationId: string, input: {
+        bytes: Uint8Array;
+        filename?: string;
+        mime?: string;
+    }): Promise<{
+        id: string;
+        size: number;
+        mime: string;
+        filename: string;
+    }>;
+    readBlob(conversationId: string, blobId: string): Promise<{
+        bytes: Buffer;
+        mime: string;
+        filename: string;
+        size: number;
+    }>;
+    deleteUnreferencedBlob(conversationId: string, blobId: string): Promise<{
+        deleted: boolean;
+        blob_id: string;
+    }>;
+    private refreshTitleFromHermesWithRetries;
+    private refreshTitleFromHermes;
+    private persistConversationStats;
+    private appendEvent;
+    private abortActiveRunsForConversation;
+    private hasActiveRunControllerForConversation;
+    private liveEventName;
+}
+
 interface CreateAppOptions {
     paths?: RuntimePaths;
     logger?: FileLogger;
+    conversations?: ConversationService;
     onPairingClaimed?: () => void | Promise<void>;
 }
 declare function createApp(options?: CreateAppOptions): Promise<Koa>;

package/dist/http/app.js

@@ -1,6 +1,6 @@
 import {
   createApp
-} from "../chunk-QAPDGN52.js";
+} from "../chunk-TMCXOV6J.js";
 export {
   createApp
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hermespilot/link",
-  "version": "0.1.9",
+  "version": "0.2.0",
   "private": false,
   "description": "Hermes Link companion service and CLI for connecting hermes-agent through HermesPilot",
   "license": "MIT",