@pellux/goodvibes-sdk 0.18.14 → 0.18.15

package/dist/_internal/platform/daemon/facade.js

@@ -0,0 +1,483 @@
+import { logger } from '@pellux/goodvibes-sdk/platform/utils/logger';
+import { jsonErrorResponse } from '@pellux/goodvibes-sdk/platform/daemon/http/error-response';
+import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils/error-display';
+import { AgentManager } from '../tools/agent/index.js';
+import {} from '../runtime/remote/index.js';
+import { isSurfaceDeliveryEnabled } from './surface-policy.js';
+import { configureDaemonSessionContinuation, createDaemonFacadeCollaborators, resolveDaemonFacadeRuntime, } from './facade-composition.js';
+import { GlobalNetworkTransportInstaller, resolveInboundTlsContext, } from '../runtime/network/index.js';
+import { createRuntimeServices } from '../runtime/services.js';
+import { readAutomationReasoningEffort, readAutomationWakeMode, readExternalContentSource, readStringList, } from './helpers.js';
+// ---------------------------------------------------------------------------
+// DaemonServer
+// ---------------------------------------------------------------------------
+/**
+ * DaemonServer — HTTP task server, disabled by default.
+ *
+ * Enable via: danger.daemon = true in config.
+ * All routes require Bearer token auth (set via enable()).
+ * POST /task    — submit a task; returns agentId.
+ * GET  /task/:id — returns agent status.
+ * GET  /status  — server health check.
+ */
+export class DaemonServer {
+    config;
+    enabled = false;
+    server = null;
+    port;
+    host;
+    agentManager;
+    runtimeServices;
+    integrationHelpers;
+    configManager;
+    authToken = null;
+    userAuth;
+    githubWebhookSecret;
+    automationManager;
+    runtimeBus;
+    runtimeStore;
+    runtimeDispatch;
+    controlPlaneGateway;
+    gatewayMethods;
+    sessionBroker;
+    approvalBroker;
+    routeBindings;
+    deliveryManager;
+    surfaceRegistry;
+    channelPolicy;
+    channelPlugins;
+    channelReplyPipeline;
+    providerRuntime;
+    builtinChannels;
+    watcherRegistry;
+    platformServiceManager;
+    distributedRuntime;
+    voiceService;
+    webSearchService;
+    knowledgeService;
+    knowledgeGraphqlService;
+    mediaProviders;
+    multimodalService;
+    artifactStore;
+    serviceRegistry;
+    serveFactory;
+    pendingSurfaceReplies = new Map();
+    controlPlaneHelper;
+    surfaceDeliveryHelper;
+    surfaceActionHelper;
+    transportEventsHelper;
+    httpRouter;
+    replyPoller = null;
+    tlsState = null;
+    approvalBrokerUnsubscribe = null;
+    constructor(config = {}, _configManager) {
+        this.config = config;
+        const resolved = resolveDaemonFacadeRuntime(config, _configManager);
+        this.configManager = resolved.configManager;
+        this.runtimeServices = resolved.runtimeServices;
+        this.integrationHelpers = resolved.integrationHelpers;
+        this.port = resolved.port;
+        this.host = resolved.host;
+        this.agentManager = resolved.agentManager;
+        this.userAuth = resolved.userAuth;
+        this.automationManager = resolved.automationManager;
+        this.runtimeBus = resolved.runtimeBus;
+        this.runtimeStore = resolved.runtimeStore;
+        this.runtimeDispatch = resolved.runtimeDispatch;
+        this.controlPlaneGateway = resolved.controlPlaneGateway;
+        this.gatewayMethods = resolved.gatewayMethods;
+        this.sessionBroker = resolved.sessionBroker;
+        this.approvalBroker = resolved.approvalBroker;
+        this.routeBindings = resolved.routeBindings;
+        this.deliveryManager = resolved.deliveryManager;
+        this.surfaceRegistry = resolved.surfaceRegistry;
+        this.channelPolicy = resolved.channelPolicy;
+        this.channelPlugins = resolved.channelPlugins;
+        this.watcherRegistry = resolved.watcherRegistry;
+        this.platformServiceManager = resolved.platformServiceManager;
+        this.distributedRuntime = resolved.distributedRuntime;
+        this.voiceService = resolved.voiceService;
+        this.webSearchService = resolved.webSearchService;
+        this.knowledgeService = resolved.knowledgeService;
+        this.knowledgeGraphqlService = resolved.knowledgeGraphqlService;
+        this.mediaProviders = resolved.mediaProviders;
+        this.multimodalService = resolved.multimodalService;
+        this.artifactStore = resolved.artifactStore;
+        this.serviceRegistry = resolved.serviceRegistry;
+        this.serveFactory = resolved.serveFactory;
+        this.githubWebhookSecret = resolved.githubWebhookSecret;
+        const collaborators = createDaemonFacadeCollaborators({
+            runtime: resolved,
+            pendingSurfaceReplies: this.pendingSurfaceReplies,
+            authToken: () => this.authToken,
+            trustProxyEnabled: () => this.trustProxyEnabled(),
+            dispatchApiRoutes: (req) => this.dispatchApiRoutes(req),
+            parseJsonBody: (req) => this.parseJsonBody(req),
+            requireAuthenticatedSession: (req) => this.requireAuthenticatedSession(req),
+            trySpawnAgent: (input, logLabel, sessionId) => this.trySpawnAgent(input, logLabel, sessionId),
+            checkAuth: (req) => this.checkAuth(req),
+            extractAuthToken: (req) => this.extractAuthToken(req),
+            requireAdmin: (req) => this.requireAdmin(req),
+            requireRemotePeer: (req, scope) => this.requireRemotePeer(req, scope),
+            describeAuthenticatedPrincipal: (token) => this.describeAuthenticatedPrincipal(token),
+            invokeGatewayMethodCall: (input) => this.invokeGatewayMethodCall(input),
+            syncSpawnedAgentTask: (record, sessionId) => this.syncSpawnedAgentTask(record, sessionId),
+            syncFinishedAgentTask: (record) => this.syncFinishedAgentTask(record),
+            surfaceDeliveryEnabled: (surface) => this.surfaceDeliveryEnabled(surface),
+            signWebhookPayload: (body, secret) => this.signWebhookPayload(body, secret),
+            handleApprovalAction: (approvalId, action, req) => this.handleApprovalAction(approvalId, action, req),
+            tlsState: () => this.tlsState,
+        });
+        this.channelReplyPipeline = collaborators.channelReplyPipeline;
+        this.controlPlaneHelper = collaborators.controlPlaneHelper;
+        this.surfaceDeliveryHelper = collaborators.surfaceDeliveryHelper;
+        this.surfaceActionHelper = collaborators.surfaceActionHelper;
+        this.transportEventsHelper = collaborators.transportEventsHelper;
+        this.httpRouter = collaborators.httpRouter;
+        this.providerRuntime = collaborators.providerRuntime;
+        this.builtinChannels = collaborators.builtinChannels;
+        configureDaemonSessionContinuation({
+            sessionBroker: this.sessionBroker,
+            trySpawnAgent: (input, logLabel, sessionId) => this.trySpawnAgent(input, logLabel, sessionId),
+            queueSurfaceReplyFromBinding: (binding, input) => this.surfaceDeliveryHelper.queueSurfaceReplyFromBinding(binding, input),
+        });
+        this.distributedRuntime.attachRuntime({
+            sessionBridge: this.sessionBroker,
+            approvalBridge: this.approvalBroker,
+            automationBridge: this.automationManager,
+            eventPublisher: (event, payload) => {
+                this.controlPlaneGateway.publishEvent(event, payload);
+            },
+        });
+    }
+    listRecentControlPlaneEvents(limit = 100) {
+        return this.controlPlaneGateway.listRecentEvents(limit);
+    }
+    /**
+     * Enable the daemon. Requires danger.daemon = true in config.
+     * The provided token is used to authenticate all incoming requests.
+     * Returns true if enabled, false if the config forbids it.
+     */
+    enable(dangerConfig, token) {
+        if (!dangerConfig.daemon) {
+            logger.info('DaemonServer.enable: danger.daemon is false — not enabling');
+            return false;
+        }
+        this.enabled = true;
+        this.authToken = token ?? null;
+        this.controlPlaneGateway.setServerState({ enabled: true, host: this.host, port: this.port });
+        return true;
+    }
+    /**
+     * Start the daemon. Refuses to start if not explicitly enabled.
+     */
+    async start() {
+        if (!this.enabled) {
+            logger.info('Daemon mode is disabled. Enable via danger.daemon config.');
+            return;
+        }
+        if (this.authToken === null) {
+            logger.info('DaemonServer: starting with session-based authentication via UserAuth');
+        }
+        if (this.server !== null) {
+            logger.info('DaemonServer: already running');
+            return;
+        }
+        new GlobalNetworkTransportInstaller().install(this.configManager);
+        if (!this.approvalBrokerUnsubscribe) {
+            this.approvalBrokerUnsubscribe = this.approvalBroker.subscribe((approval) => {
+                void this.surfaceDeliveryHelper.notifyApprovalUpdate(approval);
+            });
+        }
+        this.routeBindings.attachRuntime({
+            runtimeBus: this.runtimeBus,
+            runtimeStore: this.runtimeStore,
+        });
+        this.surfaceRegistry.attachRuntime(this.runtimeStore);
+        this.deliveryManager.attachRuntime({
+            runtimeBus: this.runtimeBus,
+            runtimeStore: this.runtimeStore,
+        });
+        this.automationManager.attachRuntime({
+            runtimeBus: this.runtimeBus,
+            runtimeStore: this.runtimeStore,
+            deliveryManager: this.deliveryManager,
+        });
+        this.controlPlaneGateway.attachRuntime({
+            runtimeBus: this.runtimeBus,
+            runtimeStore: this.runtimeStore,
+        });
+        const self = this;
+        this.transportEventsHelper.emitTransportInitializing();
+        try {
+            this.tlsState = resolveInboundTlsContext(this.configManager, 'controlPlane');
+            this.server = this.serveFactory({
+                port: this.port,
+                hostname: this.host,
+                ...(this.tlsState.tls ? { tls: this.tlsState.tls } : {}),
+                async fetch(req, server) {
+                    const upgrade = self.tryUpgradeControlPlaneWebSocket(req, server);
+                    if (upgrade === 'upgraded')
+                        return;
+                    if (upgrade)
+                        return upgrade;
+                    return self.handleRequest(req);
+                },
+                websocket: {
+                    open(ws) {
+                        self.handleControlPlaneWebSocketOpen(ws);
+                    },
+                    message(ws, message) {
+                        void self.handleControlPlaneWebSocketMessage(ws, message);
+                    },
+                    close(ws) {
+                        self.handleControlPlaneWebSocketClose(ws);
+                    },
+                },
+            });
+            await Promise.all([
+                this.sessionBroker.start(),
+                this.approvalBroker.start(),
+                this.channelPolicy.start(),
+                this.automationManager.start(),
+                this.distributedRuntime.start(),
+            ]);
+            await this.providerRuntime.startConfigured();
+            if (this.replyPoller === null) {
+                this.replyPoller = setInterval(() => {
+                    void this.pollPendingSurfaceReplies();
+                }, 2_000);
+            }
+            this.surfaceRegistry.syncConfiguredSurfaces();
+            if (this.configManager.get('watchers.enabled')) {
+                this.watcherRegistry.registerPollingWatcher({
+                    id: 'daemon-heartbeat',
+                    label: 'Daemon heartbeat',
+                    source: {
+                        id: 'source:daemon-heartbeat',
+                        kind: 'watcher',
+                        label: 'Daemon heartbeat',
+                        enabled: true,
+                        createdAt: Date.now(),
+                        updatedAt: Date.now(),
+                        metadata: {},
+                    },
+                    intervalMs: Number(this.configManager.get('watchers.heartbeatIntervalMs') ?? 30_000),
+                    run: () => new Date().toISOString(),
+                });
+                this.watcherRegistry.startWatcher('daemon-heartbeat');
+            }
+            this.controlPlaneGateway.setServerState({ enabled: true, host: this.host, port: this.port });
+            this.transportEventsHelper.emitTransportConnected();
+            logger.info('DaemonServer started', {
+                port: this.port,
+                host: this.host,
+                tlsMode: this.tlsState.mode,
+                scheme: this.tlsState.scheme,
+                trustProxy: this.tlsState.trustProxy,
+            });
+        }
+        catch (err) {
+            const message = summarizeError(err);
+            if (this.replyPoller !== null) {
+                clearInterval(this.replyPoller);
+                this.replyPoller = null;
+            }
+            this.pendingSurfaceReplies.clear();
+            this.automationManager.stop();
+            this.providerRuntime.stopAll();
+            this.watcherRegistry.stopWatcher('daemon-heartbeat', 'daemon-start-failed');
+            this.approvalBrokerUnsubscribe?.();
+            this.approvalBrokerUnsubscribe = null;
+            if (this.server !== null) {
+                this.server.stop(true);
+                this.server = null;
+            }
+            this.tlsState = null;
+            this.controlPlaneGateway.setServerState({ enabled: this.enabled, host: this.host, port: this.port });
+            this.transportEventsHelper.emitTransportTerminalFailure(message);
+            throw err;
+        }
+    }
+    /**
+     * Stop the daemon server.
+     */
+    async stop() {
+        if (this.server === null)
+            return;
+        this.automationManager.stop();
+        this.providerRuntime.stopAll();
+        this.watcherRegistry.stopWatcher('daemon-heartbeat', 'daemon-stopped');
+        if (this.replyPoller !== null) {
+            clearInterval(this.replyPoller);
+            this.replyPoller = null;
+        }
+        this.pendingSurfaceReplies.clear();
+        this.approvalBrokerUnsubscribe?.();
+        this.approvalBrokerUnsubscribe = null;
+        this.httpRouter.dispose();
+        this.server.stop(true);
+        this.server = null;
+        this.tlsState = null;
+        this.controlPlaneGateway.setServerState({ enabled: this.enabled, host: this.host, port: this.port });
+        this.transportEventsHelper.emitTransportDisconnected('Daemon server stopped', false);
+        logger.info('DaemonServer stopped');
+    }
+    /**
+     * Returns true if the server is currently running.
+     */
+    get isRunning() {
+        return this.server !== null;
+    }
+    // -------------------------------------------------------------------------
+    // Auth
+    // -------------------------------------------------------------------------
+    extractAuthToken(req) {
+        return this.controlPlaneHelper.extractAuthToken(req);
+    }
+    checkAuth(req) {
+        return this.controlPlaneHelper.checkAuth(req);
+    }
+    requireAuthenticatedSession(req) {
+        return this.controlPlaneHelper.requireAuthenticatedSession(req);
+    }
+    requireAdmin(req) {
+        return this.controlPlaneHelper.requireAdmin(req);
+    }
+    async requireRemotePeer(req, scope) {
+        return await this.controlPlaneHelper.requireRemotePeer(req, scope);
+    }
+    describeAuthenticatedPrincipal(token) {
+        return this.controlPlaneHelper.describeAuthenticatedPrincipal(token);
+    }
+    getGrantedGatewayScopes(includeWrite) {
+        return this.controlPlaneHelper.getGrantedGatewayScopes(includeWrite);
+    }
+    validateGatewayInvocation(descriptor, context) {
+        return this.controlPlaneHelper.validateGatewayInvocation(descriptor, context);
+    }
+    tryUpgradeControlPlaneWebSocket(req, server) {
+        return this.controlPlaneHelper.tryUpgradeControlPlaneWebSocket(req, server);
+    }
+    handleControlPlaneWebSocketOpen(ws) {
+        this.controlPlaneHelper.handleControlPlaneWebSocketOpen(ws);
+    }
+    async handleControlPlaneWebSocketMessage(ws, message) {
+        await this.controlPlaneHelper.handleControlPlaneWebSocketMessage(ws, message);
+    }
+    handleControlPlaneWebSocketClose(ws) {
+        this.controlPlaneHelper.handleControlPlaneWebSocketClose(ws);
+    }
+    async invokeWebSocketControlPlaneCall(input) {
+        return await this.controlPlaneHelper.invokeWebSocketControlPlaneCall(input);
+    }
+    async invokeGatewayMethodCall(input) {
+        return await this.controlPlaneHelper.invokeGatewayMethodCall(input);
+    }
+    // -------------------------------------------------------------------------
+    // Request handling
+    // -------------------------------------------------------------------------
+    async handleRequest(req) {
+        return await this.httpRouter.handleRequest(req);
+    }
+    async dispatchApiRoutes(req) {
+        return await this.httpRouter.dispatchApiRoutes(req);
+    }
+    async parseJsonBody(req) {
+        return await this.httpRouter.parseJsonBody(req);
+    }
+    async parseOptionalJsonBody(req) {
+        return await this.httpRouter.parseOptionalJsonBody(req);
+    }
+    parseJsonText(rawBody) {
+        return this.httpRouter.parseJsonText(rawBody);
+    }
+    recordApiResponse(req, path, response, clientKind = 'web') {
+        return this.httpRouter.recordApiResponse(req, path, response, clientKind);
+    }
+    async handleApprovalAction(approvalId, action, req) {
+        const body = await this.parseOptionalJsonBody(req);
+        const payload = body instanceof Response || body === null ? {} : body;
+        const actor = this.requireAuthenticatedSession(req)?.username ?? (this.authToken ? 'shared-token' : 'operator');
+        const note = typeof payload.note === 'string' ? payload.note : undefined;
+        if (action === 'claim') {
+            const approval = await this.approvalBroker.claimApproval(approvalId, actor, 'web', note);
+            return approval
+                ? this.recordApiResponse(req, `/api/approvals/${approvalId}/${action}`, Response.json({ approval }))
+                : this.recordApiResponse(req, `/api/approvals/${approvalId}/${action}`, Response.json({ error: 'Unknown approval' }, { status: 404 }));
+        }
+        if (action === 'cancel') {
+            const approval = await this.approvalBroker.cancelApproval(approvalId, actor, 'web', note);
+            return approval
+                ? this.recordApiResponse(req, `/api/approvals/${approvalId}/${action}`, Response.json({ approval }))
+                : this.recordApiResponse(req, `/api/approvals/${approvalId}/${action}`, Response.json({ error: 'Unknown approval' }, { status: 404 }));
+        }
+        const approval = await this.approvalBroker.resolveApproval(approvalId, {
+            approved: action === 'approve',
+            remember: typeof payload.remember === 'boolean' ? payload.remember : false,
+            actor,
+            actorSurface: 'web',
+            note,
+        });
+        return approval
+            ? this.recordApiResponse(req, `/api/approvals/${approvalId}/${action}`, Response.json({ approval }))
+            : this.recordApiResponse(req, `/api/approvals/${approvalId}/${action}`, Response.json({ error: 'Unknown approval' }, { status: 404 }));
+    }
+    trySpawnAgent(input, logLabel = 'DaemonServer', sessionId) {
+        try {
+            const spawnInput = Array.isArray(input.tools)
+                ? {
+                    ...input,
+                    tools: [...(input.tools ?? [])],
+                }
+                : input;
+            const record = this.agentManager.spawn(spawnInput);
+            this.syncSpawnedAgentTask(record, sessionId);
+            return record;
+        }
+        catch (err) {
+            const message = summarizeError(err);
+            logger.error(`${logLabel}: agent spawn failed`, { error: message });
+            return jsonErrorResponse(err, { status: 500, fallbackMessage: 'Failed to spawn agent' });
+        }
+    }
+    syncSpawnedAgentTask(record, sessionId) {
+        this.runtimeDispatch?.syncRuntimeTask({
+            id: record.id,
+            kind: 'agent',
+            title: record.task.length > 80 ? `${record.task.slice(0, 77)}...` : record.task,
+            description: record.task,
+            status: record.status === 'pending' ? 'queued' : 'running',
+            owner: record.id,
+            cancellable: true,
+            childTaskIds: [],
+            queuedAt: record.startedAt,
+            startedAt: record.status === 'pending' ? undefined : record.startedAt,
+            correlationId: sessionId,
+        }, 'daemon.server.agent-spawn');
+    }
+    syncFinishedAgentTask(record) {
+        const status = record.status === 'completed'
+            ? 'completed'
+            : record.status === 'failed'
+                ? 'failed'
+                : 'cancelled';
+        this.runtimeDispatch?.transitionRuntimeTask(record.id, status, {
+            endedAt: record.completedAt ?? Date.now(),
+            result: record.fullOutput ?? record.streamingContent,
+            error: record.error,
+        }, 'daemon.server.agent-finish');
+    }
+    surfaceDeliveryEnabled(surface) {
+        return isSurfaceDeliveryEnabled(this.configManager, surface);
+    }
+    async pollPendingSurfaceReplies() {
+        await this.surfaceDeliveryHelper.pollPendingSurfaceReplies((record) => this.syncFinishedAgentTask(record));
+    }
+    trustProxyEnabled() {
+        return this.tlsState?.trustProxy ?? Boolean(this.configManager.get('controlPlane.trustProxy'));
+    }
+    signWebhookPayload(body, secret) {
+        return this.surfaceDeliveryHelper.signWebhookPayload(body, secret);
+    }
+}

package/dist/_internal/platform/daemon/helpers.d.ts

@@ -0,0 +1,13 @@
+import type { AutomationExternalContentSource, AutomationWakeMode } from '../automation/index.js';
+import type { AutomationExecutionPolicy } from '../automation/index.js';
+export type { ChannelConversationKind, ChannelLifecycleAction, JsonRecord } from '@pellux/goodvibes-sdk/platform/daemon/http/route-helpers';
+export { isJsonRecord, missingScopes, readChannelConversationKind, readChannelLifecycleAction, scopeMatches, } from '@pellux/goodvibes-sdk/platform/daemon/http/route-helpers';
+export declare function readStringList(value: unknown): string[] | undefined;
+export declare function resolveGatewayPathTemplate(template: string, query?: Record<string, unknown>, body?: unknown): {
+    readonly path: string | null;
+    readonly missing: readonly string[];
+};
+export declare function readAutomationWakeMode(value: unknown): AutomationWakeMode | undefined;
+export declare function readAutomationReasoningEffort(value: unknown): AutomationExecutionPolicy['reasoningEffort'] | undefined;
+export declare function readExternalContentSource(value: unknown): AutomationExternalContentSource | undefined;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/_internal/platform/daemon/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/daemon/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAClG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAUxE,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,0DAA0D,CAAC;AAC5I,OAAO,EACL,YAAY,EACZ,aAAa,EACb,2BAA2B,EAC3B,0BAA0B,EAC1B,YAAY,GACb,MAAM,0DAA0D,CAAC;AAElE,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAUnE;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,CAAC,EAAE,OAAO,GACb;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAmBvE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAErF;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,yBAAyB,CAAC,iBAAiB,CAAC,GAAG,SAAS,CAEtH;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,+BAA+B,GAAG,SAAS,CAQrG"}

package/dist/_internal/platform/daemon/helpers.js

@@ -0,0 +1,48 @@
+import { isJsonRecord, missingScopes, readChannelConversationKind, readChannelLifecycleAction, scopeMatches, } from '@pellux/goodvibes-sdk/platform/daemon/http/route-helpers';
+export { isJsonRecord, missingScopes, readChannelConversationKind, readChannelLifecycleAction, scopeMatches, } from '@pellux/goodvibes-sdk/platform/daemon/http/route-helpers';
+export function readStringList(value) {
+    if (Array.isArray(value)) {
+        return value
+            .filter((entry) => typeof entry === 'string' && entry.trim().length > 0)
+            .map((entry) => entry.trim());
+    }
+    if (typeof value === 'string') {
+        return value.split(',').map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+    }
+    return undefined;
+}
+export function resolveGatewayPathTemplate(template, query, body) {
+    const bodyRecord = isJsonRecord(body) ? body : null;
+    const missingParams = [];
+    const path = template.replace(/\{([^}]+)\}/g, (_full, rawKey) => {
+        const key = rawKey.trim();
+        const queryValue = query?.[key];
+        const bodyValue = bodyRecord?.[key];
+        const value = typeof queryValue === 'string' || typeof queryValue === 'number'
+            ? queryValue
+            : typeof bodyValue === 'string' || typeof bodyValue === 'number'
+                ? bodyValue
+                : null;
+        if (value === null) {
+            missingParams.push(key);
+            return `{${key}}`;
+        }
+        return encodeURIComponent(String(value));
+    });
+    return missingParams.length > 0 ? { path: null, missing: missingParams } : { path, missing: [] };
+}
+export function readAutomationWakeMode(value) {
+    return value === 'now' || value === 'next-heartbeat' ? value : undefined;
+}
+export function readAutomationReasoningEffort(value) {
+    return value === 'instant' || value === 'low' || value === 'medium' || value === 'high' ? value : undefined;
+}
+export function readExternalContentSource(value) {
+    if (typeof value === 'string' && value.trim().length > 0) {
+        return value.trim();
+    }
+    if (value && typeof value === 'object') {
+        return value;
+    }
+    return undefined;
+}

package/dist/_internal/platform/daemon/http/router-route-contexts.d.ts

@@ -0,0 +1,71 @@
+import type { ConfigManager } from '../../config/manager.js';
+import type { ChannelPluginRegistry, ChannelPolicyManager, RouteBindingManager, SurfaceRegistry } from '../../channels/index.js';
+import type { KnowledgeGraphqlService, KnowledgeService } from '../../knowledge/index.js';
+import type { ArtifactStore } from '@pellux/goodvibes-sdk/platform/artifacts/index';
+import type { MediaProviderRegistry } from '../../media/index.js';
+import type { MultimodalService } from '../../multimodal/index.js';
+import type { VoiceService } from '@pellux/goodvibes-sdk/platform/voice/index';
+import type { WebSearchService } from '../../web-search/index.js';
+import type { IntegrationHelperService } from '../../runtime/integration/helpers.js';
+import type { ApprovalBroker } from '../../control-plane/index.js';
+import type { PlatformServiceManager } from '../service-manager.js';
+import type { JsonRecord } from '../helpers.js';
+import type { WatcherRegistry } from '../../watchers/index.js';
+import type { DaemonChannelRouteContext } from '@pellux/goodvibes-sdk/platform/daemon/http/channel-route-types';
+import type { DaemonIntegrationRouteContext } from '@pellux/goodvibes-sdk/platform/daemon/http/integration-route-types';
+import type { DaemonKnowledgeRouteContext } from '@pellux/goodvibes-sdk/platform/daemon/http/knowledge-route-types';
+import type { DaemonMediaRouteContext } from '@pellux/goodvibes-sdk/platform/daemon/http/media-route-types';
+import type { DaemonSystemRouteContext } from '@pellux/goodvibes-sdk/platform/daemon/http/system-route-types';
+export declare function buildChannelRouteContext(input: {
+    readonly channelPlugins: ChannelPluginRegistry;
+    readonly channelPolicy: ChannelPolicyManager;
+    readonly parseJsonBody: (request: Request) => Promise<JsonRecord | Response>;
+    readonly parseOptionalJsonBody: (request: Request) => Promise<JsonRecord | null | Response>;
+    readonly requireAdmin: (request: Request) => Response | null;
+    readonly surfaceRegistry: SurfaceRegistry;
+}): DaemonChannelRouteContext;
+export declare function buildSystemRouteContext(input: {
+    readonly approvalBroker: ApprovalBroker;
+    readonly configManager: ConfigManager;
+    readonly integrationHelpers: IntegrationHelperService | null;
+    readonly inspectInboundTls: (surface: 'controlPlane' | 'httpListener') => unknown;
+    readonly inspectOutboundTls: () => unknown;
+    readonly isValidConfigKey: (key: string) => boolean;
+    readonly parseJsonBody: (request: Request) => Promise<JsonRecord | Response>;
+    readonly parseOptionalJsonBody: (request: Request) => Promise<JsonRecord | null | Response>;
+    readonly platformServiceManager: PlatformServiceManager;
+    readonly recordApiResponse: (request: Request, path: string, response: Response, clientKind?: DaemonSystemRouteContext['recordApiResponse'] extends (req: Request, path: string, response: Response, clientKind?: infer T) => Response ? T : never) => Response;
+    readonly requireAdmin: (request: Request) => Response | null;
+    readonly requireAuthenticatedSession: (request: Request) => {
+        username: string;
+        roles: readonly string[];
+    } | null;
+    readonly routeBindings: RouteBindingManager;
+    readonly watcherRegistry: WatcherRegistry;
+}): DaemonSystemRouteContext;
+export declare function buildKnowledgeRouteContext(input: {
+    readonly configManager: ConfigManager;
+    readonly inspectGraphqlAccess: DaemonKnowledgeRouteContext['inspectGraphqlAccess'];
+    readonly normalizeAtSchedule: DaemonKnowledgeRouteContext['normalizeAtSchedule'];
+    readonly normalizeEverySchedule: DaemonKnowledgeRouteContext['normalizeEverySchedule'];
+    readonly normalizeCronSchedule: DaemonKnowledgeRouteContext['normalizeCronSchedule'];
+    readonly parseJsonBody: (request: Request) => Promise<JsonRecord | Response>;
+    readonly parseOptionalJsonBody: (request: Request) => Promise<JsonRecord | null | Response>;
+    readonly parseJsonText: (raw: string) => JsonRecord | Response;
+    readonly requireAdmin: (request: Request) => Response | null;
+    readonly resolveAuthenticatedPrincipal: (request: Request) => ReturnType<DaemonKnowledgeRouteContext['resolveAuthenticatedPrincipal']>;
+    readonly knowledgeService: KnowledgeService;
+    readonly knowledgeGraphqlService: KnowledgeGraphqlService;
+}): DaemonKnowledgeRouteContext;
+export declare function buildMediaRouteContext(input: {
+    readonly artifactStore: ArtifactStore;
+    readonly configManager: ConfigManager;
+    readonly mediaProviders: MediaProviderRegistry;
+    readonly multimodalService: MultimodalService;
+    readonly parseJsonBody: (request: Request) => Promise<JsonRecord | Response>;
+    readonly requireAdmin: (request: Request) => Response | null;
+    readonly voiceService: VoiceService;
+    readonly webSearchService: WebSearchService;
+}): DaemonMediaRouteContext;
+export declare function buildIntegrationRouteContext(input: DaemonIntegrationRouteContext): DaemonIntegrationRouteContext;
+//# sourceMappingURL=router-route-contexts.d.ts.map

package/dist/_internal/platform/daemon/http/router-route-contexts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-route-contexts.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/daemon/http/router-route-contexts.ts"],"names":[],"mappings":"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"}