@nordbyte/nordrelay 0.8.0 → 0.8.2

package/dist/runtime/relay-runtime-dashboard.js

@@ -0,0 +1,201 @@
+import { randomUUID } from "node:crypto";
+import { ensureOutDir } from "../artifacts/artifacts.js";
+import { buildFileInstructions, outboxPath, stageFile, } from "../artifacts/attachments.js";
+import { CODEX_AGENT_CAPABILITIES, agentLabel, agentReasoningLabel, agentReasoningOptions, isAgentId, } from "../agents/shared/agent.js";
+import { getExternalSnapshotForSession } from "../agents/shared/agent-activity.js";
+import { listAgentAdapterDescriptors } from "../agents/shared/agent-adapter.js";
+import { AgentUpdateManager } from "../agents/shared/agent-updates.js";
+import { createAgentSessionService, enabledAgents } from "../agents/shared/agent-factory.js";
+import { AuditLogStore } from "../access/audit-log.js";
+import { BotPreferencesStore } from "../state/bot-preferences.js";
+import { ChannelCommandService } from "../channels/shared/channel-command-service.js";
+import { ChannelTurnService } from "../channels/shared/channel-turn-service.js";
+import { activeSessionSourceForContextKey, ChannelMirrorRegistry } from "../channels/shared/channel-mirror-registry.js";
+import { listThreads as listCodexThreads } from "../agents/codex/codex-state.js";
+import { friendlyErrorText } from "../core/error-messages.js";
+import { clearLogFile, getAgentUpdateLogPath, getConnectorHealth, getConnectorLogPath, getPackageVersion, getUpdateLogPath, getVersionChecks, readConnectorState, readFormattedLogTail, spawnConnectorRestart, spawnSelfUpdate } from "../support/operations.js";
+import { PromptStore, toPromptEnvelope } from "../state/prompt-store.js";
+import { UnifiedJobStore } from "../state/job-store.js";
+import { buildRuntimeMetrics } from "./metrics.js";
+import { RelayArtifactService } from "./relay-artifact-service.js";
+import { RelayAuthService } from "./relay-auth-service.js";
+import { RelayExternalActivityMonitor } from "./relay-external-activity-monitor.js";
+import { RelayQueueService } from "./relay-queue-service.js";
+import { RuntimeSnapshotCache } from "./runtime-cache.js";
+import { activeSessionPriority, activityToUnifiedJob, agentUpdateStatusToUnified, dedupeJobs, hostLoginCommand, hostLogoutCommand, isPromptTerminalActivity, normalizeMimeType, promptActivityToUnifiedJob, shouldRefreshActiveSessions, taskToUnifiedJob, uploadFileDtos, } from "./relay-runtime-helpers.js";
+import { RelayDashboardService } from "./relay-dashboard-service.js";
+import { capabilitiesOf } from "../channels/shared/bot-rendering.js";
+import { renderSessionInfoPlain, renderSessionUsageRows } from "../channels/shared/session-format.js";
+import { SessionLockStore } from "../access/session-locks.js";
+import { SessionRegistry } from "../state/session-registry.js";
+import { createSupportBundle } from "../support/support-bundle.js";
+import { transcribeAudio } from "../artifacts/voice.js";
+import { WebActivityStore, WebChatStore, } from "../web/web-state.js";
+import { evaluateWorkspacePolicy, filterAllowedWorkspaces } from "../core/workspace-policy.js";
+export const WEB_CONTEXT_KEY = "web:dashboard";
+const ACTIVE_CODEX_DISCOVERY_LIMIT = 200;
+const ACTIVE_ACTIVITY_TTL_MS = 6 * 60 * 60 * 1000;
+const MAX_WEB_SESSION_PAGE_SIZE = 50;
+const MAX_CHAT_HISTORY = 250;
+export function relayRuntimeSubscribe(runtime, callback) {
+    runtime.subscribers.add(callback);
+    void runtime.snapshot().then((data) => callback({ type: "snapshot", data })).catch(() => { });
+    void runtime.chatHistory().then((messages) => callback({ type: "chat_history", messages })).catch(() => { });
+    void runtime.activeSessions().then((active) => callback({ type: "active_sessions_update", active })).catch(() => { });
+    callback({ type: "activity_update", events: runtime.activity({ limit: 50 }) });
+    return () => runtime.subscribers.delete(callback);
+}
+export async function relayRuntimeSnapshot(runtime) {
+    const session = await runtime.getSession(true);
+    const info = runtime.publicInfo(session);
+    return {
+        session: info,
+        sessionText: renderSessionInfoPlain(info),
+        queue: runtime.queue(),
+        queuePaused: runtime.queuePaused(),
+        processing: session.isProcessing(),
+        enabledAgents: enabledAgents(runtime.config),
+        workspaces: filterAllowedWorkspaces(session.listWorkspaces(), runtime.config),
+    };
+}
+export async function relayRuntimeStatus(runtime) {
+    const cliOptions = runtime.cliPathOptions();
+    const [health, versionChecks, snapshot] = await Promise.all([
+        getConnectorHealth(cliOptions),
+        getVersionChecks(cliOptions),
+        runtime.snapshot(),
+    ]);
+    return {
+        health,
+        versionChecks,
+        snapshot,
+    };
+}
+export async function relayRuntimeBootstrapStatus(runtime) {
+    return {
+        health: {
+            version: await getPackageVersion(),
+            state: await readConnectorState(),
+        },
+        snapshot: await runtime.snapshot(),
+    };
+}
+export async function relayRuntimeVersion(runtime) {
+    return runtime.dashboardService.version();
+}
+export async function relayRuntimeDiagnostics(runtime) {
+    return runtime.dashboardService.diagnostics();
+}
+export async function relayRuntimeAdapterHealth(runtime) {
+    return runtime.dashboardService.adapterHealth();
+}
+export function relayRuntimePermissions(runtime) {
+    return {
+        mode: "users",
+        message: "Access is managed by NordRelay users, groups, Telegram identities, Telegram chat access records, Discord identities, and Discord channel access records.",
+    };
+}
+export async function relayRuntimeMetrics(runtime) {
+    const [active, jobs] = await Promise.all([
+        runtime.activeSessions(),
+        runtime.jobs(),
+    ]);
+    return buildRuntimeMetrics({
+        queueLength: runtime.queueService.length(),
+        queuePaused: runtime.queueService.isPaused(),
+        activeTurnCount: active.sessions.length,
+        jobs: jobs.jobs,
+        activity: runtime.activity({ limit: 500 }),
+    });
+}
+export function relayRuntimeAudit(runtime, options = 50) {
+    return runtime.auditStore.list(options);
+}
+export async function relayRuntimeSupportBundle(runtime, actor) {
+    const bundle = await createSupportBundle({
+        config: runtime.config,
+        diagnostics: await runtime.diagnostics(),
+        adapterHealth: await runtime.adapterHealth(),
+        auditEvents: runtime.auditStore.list(100),
+        agentUpdateJobs: runtime.agentUpdates.list(),
+        source: "web",
+    });
+    runtime.appendActivity({
+        source: "web",
+        status: "info",
+        type: "diagnostics_bundle_exported",
+        threadId: null,
+        workspace: runtime.config.workspace,
+        actor,
+        detail: bundle.path,
+    });
+    runtime.appendAudit({
+        action: "command",
+        status: "ok",
+        contextKey: runtime.contextKey,
+        actor,
+        description: "export diagnostics bundle",
+        detail: bundle.path,
+    });
+    return bundle;
+}
+export async function relayRuntimeLogs(runtime, target = "connector", lines = 100) {
+    if (target === "update") {
+        return readFormattedLogTail(lines, getUpdateLogPath());
+    }
+    if (target === "agent-updates") {
+        return readFormattedLogTail(lines, getAgentUpdateLogPath());
+    }
+    return readFormattedLogTail(lines);
+}
+export function relayRuntimeClearLogs(runtime, target = "connector", actor) {
+    const result = clearLogFile(target === "update" ? getUpdateLogPath() : target === "agent-updates" ? getAgentUpdateLogPath() : getConnectorLogPath());
+    runtime.appendActivity({
+        source: "web",
+        status: "info",
+        type: "logs_cleared",
+        threadId: null,
+        workspace: runtime.config.workspace,
+        actor,
+        detail: `Cleared ${target} log.`,
+    });
+    runtime.appendAudit({
+        action: "command",
+        status: "ok",
+        contextKey: runtime.contextKey,
+        actor,
+        description: `clear ${target} log`,
+        detail: result.filePath,
+    });
+    return { ok: true, filePath: result.filePath, clearedAt: result.clearedAt.toISOString() };
+}
+export function relayRuntimeRestartConnector(runtime, actor) {
+    spawnConnectorRestart();
+    runtime.broadcastStatus("Restart requested. The dashboard may disconnect briefly.", "warn");
+    runtime.appendActivity({
+        source: "web",
+        status: "info",
+        type: "restart_requested",
+        threadId: null,
+        workspace: runtime.config.workspace,
+        actor,
+        detail: "Dashboard requested a connector restart.",
+    });
+    runtime.appendAudit({
+        action: "command",
+        status: "ok",
+        contextKey: runtime.contextKey,
+        actor,
+        description: "restart connector",
+    });
+    return { ok: true, message: "Restart requested." };
+}
+export function relayRuntimeDispose(runtime) {
+    if (runtime.externalMonitor) {
+        clearInterval(runtime.externalMonitor);
+    }
+    runtime.dashboardService.stopBackgroundRefresh();
+    runtime.agentUpdates.cancelAll();
+    runtime.registry.disposeAll();
+    runtime.subscribers.clear();
+}

package/dist/runtime/relay-runtime-prompt-queue-artifacts.js

@@ -0,0 +1,307 @@
+import { randomUUID } from "node:crypto";
+import { ensureOutDir } from "../artifacts/artifacts.js";
+import { buildFileInstructions, outboxPath, stageFile, } from "../artifacts/attachments.js";
+import { CODEX_AGENT_CAPABILITIES, agentLabel, agentReasoningLabel, agentReasoningOptions, isAgentId, } from "../agents/shared/agent.js";
+import { getExternalSnapshotForSession } from "../agents/shared/agent-activity.js";
+import { listAgentAdapterDescriptors } from "../agents/shared/agent-adapter.js";
+import { AgentUpdateManager } from "../agents/shared/agent-updates.js";
+import { createAgentSessionService, enabledAgents } from "../agents/shared/agent-factory.js";
+import { AuditLogStore } from "../access/audit-log.js";
+import { BotPreferencesStore } from "../state/bot-preferences.js";
+import { ChannelCommandService } from "../channels/shared/channel-command-service.js";
+import { ChannelTurnService } from "../channels/shared/channel-turn-service.js";
+import { activeSessionSourceForContextKey, ChannelMirrorRegistry } from "../channels/shared/channel-mirror-registry.js";
+import { listThreads as listCodexThreads } from "../agents/codex/codex-state.js";
+import { friendlyErrorText } from "../core/error-messages.js";
+import { clearLogFile, getAgentUpdateLogPath, getConnectorHealth, getConnectorLogPath, getPackageVersion, getUpdateLogPath, getVersionChecks, readConnectorState, readFormattedLogTail, spawnConnectorRestart, spawnSelfUpdate } from "../support/operations.js";
+import { PromptStore, toPromptEnvelope } from "../state/prompt-store.js";
+import { UnifiedJobStore } from "../state/job-store.js";
+import { buildRuntimeMetrics } from "./metrics.js";
+import { RelayArtifactService } from "./relay-artifact-service.js";
+import { RelayAuthService } from "./relay-auth-service.js";
+import { RelayExternalActivityMonitor } from "./relay-external-activity-monitor.js";
+import { RelayQueueService } from "./relay-queue-service.js";
+import { RuntimeSnapshotCache } from "./runtime-cache.js";
+import { activeSessionPriority, activityToUnifiedJob, agentUpdateStatusToUnified, dedupeJobs, hostLoginCommand, hostLogoutCommand, isPromptTerminalActivity, normalizeMimeType, promptActivityToUnifiedJob, shouldRefreshActiveSessions, taskToUnifiedJob, uploadFileDtos, } from "./relay-runtime-helpers.js";
+import { RelayDashboardService } from "./relay-dashboard-service.js";
+import { capabilitiesOf } from "../channels/shared/bot-rendering.js";
+import { renderSessionInfoPlain, renderSessionUsageRows } from "../channels/shared/session-format.js";
+import { SessionLockStore } from "../access/session-locks.js";
+import { SessionRegistry } from "../state/session-registry.js";
+import { createSupportBundle } from "../support/support-bundle.js";
+import { transcribeAudio } from "../artifacts/voice.js";
+import { WebActivityStore, WebChatStore, } from "../web/web-state.js";
+import { evaluateWorkspacePolicy, filterAllowedWorkspaces } from "../core/workspace-policy.js";
+export const WEB_CONTEXT_KEY = "web:dashboard";
+const ACTIVE_CODEX_DISCOVERY_LIMIT = 200;
+const ACTIVE_ACTIVITY_TTL_MS = 6 * 60 * 60 * 1000;
+const MAX_WEB_SESSION_PAGE_SIZE = 50;
+const MAX_CHAT_HISTORY = 250;
+export async function relayRuntimeSendPrompt(runtime, text, actor) {
+    const trimmed = text.trim();
+    if (!trimmed) {
+        throw new Error("Prompt is empty.");
+    }
+    return runtime.sendEnvelope({ ...toPromptEnvelope(trimmed), activityActor: actor }, actor);
+}
+export async function relayRuntimeSendUploadPrompt(runtime, options, actor) {
+    const text = options.text?.trim() ?? "";
+    const files = options.files.filter((file) => file.data.byteLength > 0);
+    if (!text && files.length === 0) {
+        throw new Error("Prompt is empty.");
+    }
+    const session = await runtime.getSession(false);
+    const workspace = session.getInfo().workspace;
+    const turnId = randomUUID().slice(0, 12);
+    const outDir = outboxPath(workspace, turnId);
+    await ensureOutDir(outDir);
+    const stagedFiles = [];
+    const imagePaths = [];
+    const transcriptParts = [];
+    for (const [index, file] of files.entries()) {
+        const mimeType = normalizeMimeType(file.mimeType, file.name);
+        const staged = await stageFile(file.data, file.name || `upload-${index + 1}`, mimeType, {
+            workspace,
+            turnId,
+            maxFileSize: runtime.config.maxFileSize,
+        });
+        stagedFiles.push(staged);
+        if (mimeType.startsWith("image/")) {
+            imagePaths.push(staged.localPath);
+        }
+        if (mimeType.startsWith("audio/")) {
+            const result = await transcribeAudio(staged.localPath, {
+                preferredBackend: runtime.config.voicePreferredBackend === "auto"
+                    ? undefined
+                    : runtime.config.voicePreferredBackend,
+                language: runtime.config.voiceDefaultLanguage,
+            });
+            const transcript = result.text.trim();
+            if (transcript) {
+                transcriptParts.push(`Audio transcript (${staged.safeName}, via ${result.backend}):\n${transcript}`);
+                runtime.appendActivity({
+                    source: "web",
+                    status: "completed",
+                    type: "voice_transcribed",
+                    threadId: session.getInfo().threadId,
+                    workspace,
+                    agentId: session.getInfo().agentId,
+                    actor,
+                    detail: `${staged.safeName} via ${result.backend}`,
+                    durationMs: result.durationMs,
+                });
+            }
+        }
+    }
+    if (stagedFiles.length > 0) {
+        runtime.appendActivity({
+            source: "web",
+            status: "info",
+            type: "attachment_staged",
+            threadId: session.getInfo().threadId,
+            workspace,
+            agentId: session.getInfo().agentId,
+            actor,
+            detail: `${stagedFiles.length} file(s): ${stagedFiles.map((file) => file.safeName).join(", ")}`,
+        });
+    }
+    const audioOnly = stagedFiles.length > 0 && stagedFiles.every((file) => file.mimeType.startsWith("audio/"));
+    if (runtime.config.voiceTranscribeOnly && audioOnly && !text) {
+        return {
+            queued: false,
+            transcript: transcriptParts.join("\n\n"),
+            transcribeOnly: true,
+            files: uploadFileDtos(stagedFiles),
+        };
+    }
+    const promptInput = {};
+    const textParts = [text, ...transcriptParts].filter(Boolean);
+    if (textParts.length > 0) {
+        promptInput.text = textParts.join("\n\n");
+    }
+    if (imagePaths.length > 0) {
+        promptInput.imagePaths = imagePaths;
+    }
+    if (stagedFiles.length > 0) {
+        promptInput.stagedFileInstructions = buildFileInstructions(stagedFiles, outDir);
+    }
+    const result = await runtime.sendEnvelope({ ...toPromptEnvelope(promptInput, outDir), activityActor: actor }, actor);
+    return {
+        ...result,
+        transcript: transcriptParts.join("\n\n") || undefined,
+        files: uploadFileDtos(stagedFiles),
+    };
+}
+export async function relayRuntimeSendEnvelope(runtime, envelope, actor) {
+    const activityActor = envelope.activityActor ?? actor;
+    const session = await runtime.getSession(false);
+    const external = getExternalSnapshotForSession(session, runtime.config, { maxEvents: 0 });
+    if (session.isProcessing() || external?.activity.active) {
+        const queued = runtime.queueService.enqueue(envelope);
+        const info = runtime.publicInfo(session);
+        runtime.appendActivity({
+            source: "web",
+            status: "queued",
+            type: "prompt_queued",
+            threadId: info.threadId,
+            workspace: info.workspace,
+            agentId: info.agentId,
+            actor: activityActor,
+            prompt: envelope.description,
+            detail: external?.activity.active
+                ? `Queued because ${external.agentLabel} CLI is still processing another task.`
+                : `Queued at position ${runtime.queueService.length()}.`,
+        });
+        runtime.appendAudit({
+            action: "prompt_queued",
+            status: "ok",
+            contextKey: runtime.contextKey,
+            agentId: info.agentId,
+            threadId: info.threadId,
+            workspace: info.workspace,
+            promptId: queued.id,
+            actor: activityActor,
+            description: envelope.description,
+        });
+        if (external?.activity.active) {
+            runtime.broadcastStatus(`Waiting for ${external.agentLabel} CLI task... ${runtime.queueService.length()} queued.`, "info");
+        }
+        runtime.broadcastQueue();
+        return { queued: true, queueId: queued.id };
+    }
+    void runtime.runPrompt(session, { ...envelope, activityActor }).catch((error) => {
+        runtime.broadcast({ type: "turn_error", id: runtime.currentTurnId ?? "turn", error: friendlyErrorText(error), at: new Date().toISOString() });
+    });
+    return { queued: false };
+}
+export function relayRuntimeQueue(runtime) {
+    return runtime.queueService.list();
+}
+export function relayRuntimeQueuePaused(runtime) {
+    return runtime.queueService.isPaused();
+}
+export function relayRuntimeQueueAction(runtime, action, id, actor) {
+    const before = runtime.queueService.rawList();
+    const affected = id ? before.find((item) => item.id === id) : undefined;
+    runtime.queueService.apply(action, id);
+    if (id && action === "run") {
+        void runtime.drainQueue().catch((error) => runtime.broadcastStatus(friendlyErrorText(error), "error"));
+    }
+    runtime.appendActivity({
+        source: "web",
+        status: "info",
+        type: `queue_${action}`,
+        threadId: null,
+        workspace: runtime.config.workspace,
+        actor,
+        prompt: affected?.description,
+        detail: id ? `${action}: ${id}` : `${action}: ${before.length} queued`,
+    });
+    runtime.appendAudit({
+        action: "queue_updated",
+        status: "ok",
+        contextKey: runtime.contextKey,
+        actor,
+        description: id ? `${action}: ${id}` : action,
+    });
+    runtime.broadcastQueue();
+    return runtime.queue();
+}
+export async function relayRuntimeArtifacts(runtime) {
+    const session = await runtime.getSession(true);
+    return runtime.artifactService.list(session.getInfo().workspace, 20);
+}
+export async function relayRuntimeArtifact(runtime, turnId) {
+    const session = await runtime.getSession(true);
+    return runtime.artifactService.get(session.getInfo().workspace, turnId);
+}
+export async function relayRuntimeDeleteArtifact(runtime, turnId, actor) {
+    const session = await runtime.getSession(true);
+    const info = runtime.publicInfo(session);
+    const removed = await runtime.artifactService.delete(info.workspace, turnId);
+    runtime.appendActivity({
+        source: "web",
+        status: removed ? "info" : "failed",
+        type: "artifact_deleted",
+        threadId: info.threadId,
+        workspace: info.workspace,
+        agentId: info.agentId,
+        actor,
+        detail: turnId,
+    });
+    return removed;
+}
+export async function relayRuntimeCreateArtifactZip(runtime, turnId, actor) {
+    const session = await runtime.getSession(true);
+    const info = runtime.publicInfo(session);
+    const zip = await runtime.artifactService.createZip(info.workspace, turnId);
+    if (zip) {
+        runtime.appendActivity({
+            source: "web",
+            status: "info",
+            type: "artifact_zip_created",
+            threadId: info.threadId,
+            workspace: info.workspace,
+            agentId: info.agentId,
+            actor,
+            detail: zip.name,
+        });
+    }
+    return zip;
+}
+export async function relayRuntimeArtifactPreview(runtime, turnId, relativePath) {
+    const session = await runtime.getSession(true);
+    return runtime.artifactService.preview(session.getInfo().workspace, turnId, relativePath);
+}
+export async function relayRuntimeEnsureActiveThread(runtime, session) {
+    if (!session.hasActiveThread()) {
+        await session.newThread();
+        runtime.updateSession(session);
+    }
+}
+export function relayRuntimeEnsureIdle(runtime, session) {
+    if (session.isProcessing()) {
+        throw new Error("The active session is still processing a turn.");
+    }
+}
+export async function relayRuntimeRunPrompt(runtime, session, envelope) {
+    const workspacePolicy = evaluateWorkspacePolicy(session.getInfo().workspace, runtime.config);
+    if (!workspacePolicy.allowed) {
+        throw new Error(workspacePolicy.warning ?? "Current workspace is blocked by policy.");
+    }
+    try {
+        await runtime.turnService.run(session, envelope);
+    }
+    finally {
+        await runtime.drainQueue();
+    }
+}
+export async function relayRuntimeDrainQueue(runtime) {
+    if (runtime.draining || runtime.queueService.isPaused()) {
+        return;
+    }
+    runtime.draining = true;
+    try {
+        const session = await runtime.getSession(false);
+        while (!session.isProcessing()) {
+            const external = getExternalSnapshotForSession(session, runtime.config, { maxEvents: 0 });
+            if (external?.activity.active) {
+                runtime.broadcastStatus(`Waiting for ${external.agentLabel} CLI task... ${runtime.queueService.length()} queued.`, "info");
+                return;
+            }
+            const next = runtime.queueService.dequeue();
+            runtime.broadcastQueue();
+            if (!next) {
+                return;
+            }
+            await runtime.runPrompt(session, next);
+        }
+    }
+    finally {
+        runtime.draining = false;
+    }
+}
+export function relayRuntimeUpdateSession(runtime, session) {
+    runtime.registry.updateMetadata(runtime.contextKey, session);
+    runtime.broadcast({ type: "session_update", session: runtime.publicInfo(session) });
+}