Skip to content

log-import

FieldValue
Prefixlog-import
Namespace constantLogImportNamespace
Subjects constantLogImportSubjects
Kindbus
Schema recordLogImportSchemas
Tierframework
Package@makaio/services-log-import
Defined inpackages/services/log-import/src/namespace.ts
KeyWireTypeSchema
confirmation.requestlog-import.confirmation.requestrpcconfirmation.ts
confirmation.responselog-import.confirmation.responserpcconfirmation.ts
getModelog-import.getModerpcschemas.ts
getStatslog-import.getStatsrpcstats.ts
importAlllog-import.importAllrpcstats.ts
importSessionlog-import.importSessionrpcschemas.ts
listImporterslog-import.listImportersrpclist-importers.ts
listSettingslog-import.listSettingsrpcschemas.ts
progresslog-import.progressrpcstats.ts
scanlog-import.scanrpcstats.ts
setModelog-import.setModerpcschemas.ts
uploadFileslog-import.uploadFilesrpcupload.ts

Request user confirmation via UI. UI renders a modal, user clicks option, response is sent back.

Subject: log-import.confirmation.request Type: Request (RPC) Purpose: Requests user confirmation for actions like conflict resolution.

Request:

FieldTypeRequired
confirmationIdstringyes
messagestringyes
options{ id: string; label: string; variant?: "primary" | "secondary" | "danger" | undefined; }[]yes
titlestringyes

Response:

FieldTypeRequired
confirmationIdstringyes
receivedbooleanyes

User response to a log import confirmation dialog.

Subject: log-import.confirmation.response Type: Request (RPC) Purpose: Sends the user’s selection back to the requester.

Request:

FieldTypeRequired
confirmationIdstringyes
selectedOptionIdstringyes

Response:

FieldTypeRequired
acknowledgedbooleanyes

Resolve the effective global import mode for a given adapter.

Subject: log-import.getMode Type: Request (RPC) Purpose: Returns the effective global import mode for the requested adapter.

Hosts that need scoped resolution can register a higher-priority handler that falls through to this global default with ctx.next().

Request:

FieldTypeRequired
adapterNamestringyes

Response:

FieldTypeRequired
mode"disabled" | "discover" | "import"yes

Request log import stats from an adapter.

Subject: log-import.getStats Type: Request (RPC) Purpose: Returns import statistics for a specific adapter including session counts and last scan timestamp.

Request:

FieldTypeRequired
adapterNamestringyes

Response:

FieldTypeRequired
adapterNamestringyes
lastScanAtstring | nullyes
sessionsFoundnumberyes
sessionsImportednumberyes
supportsImportbooleanyes

Import all unimported sessions from an adapter.

Subject: log-import.importAll Type: Request (RPC) Purpose: Imports all sessions that haven’t been imported yet.

Request:

FieldTypeRequired
adapterNamestringyes

Response:

FieldTypeRequired
adapterNamestringyes
errorsnumberyes
importednumberyes
skippednumberyes

Lazy-load a single discovered session — fetch its full message history on demand.

Subject: log-import.importSession Type: Request (RPC) Purpose: Imports one discovered adapter session into Makaio on demand.

Request:

FieldTypeRequired
adapterNamestringyes
adapterSessionIdstringyes

Response:

FieldTypeRequired
messageCountnumberyes
sessionIdstringyes

List all registered log importers.

Subject: log-import.listImporters Type: Request (RPC) Purpose: Returns information about all registered importers (adapters + extensions).

Request:

Empty object.

Response:

FieldTypeRequired
importers{ id: string; adapterName: string; displayName: string; source: "adapter" | "extension"; logFilePattern: string; isRunning: boolean; supportsManualImport: boolean; }[]yes

List all persisted import settings rows.

Subject: log-import.listSettings Type: Request (RPC) Purpose: Returns every persisted global log-import settings row.

Request:

Empty object.

Response:

FieldTypeRequired
settings{ adapterName: string; mode: "disabled" | "discover" | "import"; createdAt: number; updatedAt: number; }[]yes

Log import progress event (emitted during long imports).

Subject: log-import.progress Type: Request (RPC - for acknowledgment pattern) Purpose: Notifies UI about import progress.

Request:

FieldTypeRequired
adapterNamestringyes
currentnumberyes
currentFilestring | undefinedno
totalnumberyes

Response:

FieldTypeRequired
receivedbooleanyes

Trigger a scan of adapter’s log directory.

Subject: log-import.scan Type: Request (RPC) Purpose: Scans the adapter’s log directory for new sessions.

Request:

FieldTypeRequired
adapterNamestringyes

Response:

FieldTypeRequired
adapterNamestringyes
newSessionsnumberyes
sessionsFoundnumberyes

Set the global import mode for an adapter.

Subject: log-import.setMode Type: Request (RPC) Purpose: Persists the global import mode for the requested adapter.

Hosts that need scoped writes can register a higher-priority handler that falls through to this global default with ctx.next().

Request:

FieldTypeRequired
adapterNamestringyes
mode"disabled" | "discover" | "import"yes

Response:

FieldTypeRequired
successbooleanyes

Upload session files for log import. Files are base64-encoded for bus transport.

Subject: log-import.uploadFiles Type: Request (RPC) Purpose: Allows users to upload session files directly for import.

Request:

FieldTypeRequired
adapterNamestringyes
files{ filename: string; contentBase64: string; }[]yes

Response:

FieldTypeRequired
adapterNamestringyes
errors{ filename: string; error: string; }[]yes
filesProcessednumberyes
sessionsImportednumberyes

Auto-generated by yarn docs:bus. Do not edit manually.