@pellux/goodvibes-sdk 0.18.3 → 0.18.12

package/dist/_internal/daemon/runtime-session-routes.js

@@ -0,0 +1,387 @@
+export function createDaemonRuntimeSessionRouteHandlers(context) {
+    return {
+        createSharedSession: async (request) => handleCreateSharedSession(context, request),
+        postTask: async (request) => handlePostTask(context, request),
+        getSharedSession: async (sessionId) => handleGetSharedSession(context, sessionId),
+        closeSharedSession: (sessionId) => handleSharedSessionLifecycle(context, sessionId, 'close'),
+        reopenSharedSession: (sessionId) => handleSharedSessionLifecycle(context, sessionId, 'reopen'),
+        getSharedSessionMessages: async (sessionId, url) => handleGetSharedSessionMessages(context, sessionId, url),
+        getSharedSessionInputs: async (sessionId, url) => handleGetSharedSessionInputs(context, sessionId, url),
+        postSharedSessionMessage: (sessionId, request) => handlePostSharedSessionMessage(context, sessionId, request),
+        postSharedSessionSteer: (sessionId, request) => handlePostSharedSessionSteer(context, sessionId, request),
+        postSharedSessionFollowUp: (sessionId, request) => handlePostSharedSessionFollowUp(context, sessionId, request),
+        cancelSharedSessionInput: (sessionId, inputId) => handleCancelSharedSessionInput(context, sessionId, inputId),
+        getRuntimeTask: (taskId) => handleGetRuntimeTask(context, taskId),
+        runtimeTaskAction: (taskId, action, request) => handleRuntimeTaskAction(context, taskId, action, request),
+        getTaskStatus: (agentId) => handleGetTaskStatus(context, agentId),
+    };
+}
+async function handleCreateSharedSession(context, req) {
+    const body = await context.parseJsonBody(req);
+    if (body instanceof Response)
+        return body;
+    await context.sessionBroker.start();
+    await context.routeBindings.start();
+    const routeBinding = typeof body.routeId === 'string'
+        ? context.routeBindings.getBinding(body.routeId)
+        : undefined;
+    const session = await context.sessionBroker.createSession({
+        id: typeof body.id === 'string' ? body.id : undefined,
+        title: typeof body.title === 'string' ? body.title : undefined,
+        metadata: typeof body.metadata === 'object' && body.metadata !== null ? body.metadata : {},
+        routeBinding,
+        participant: typeof body.surfaceKind === 'string' && typeof body.surfaceId === 'string'
+            ? {
+                surfaceKind: body.surfaceKind,
+                surfaceId: body.surfaceId,
+                externalId: typeof body.externalId === 'string' ? body.externalId : undefined,
+                userId: typeof body.userId === 'string' ? body.userId : undefined,
+                displayName: typeof body.displayName === 'string' ? body.displayName : undefined,
+                routeId: routeBinding?.id,
+                lastSeenAt: Date.now(),
+            }
+            : undefined,
+    });
+    return context.recordApiResponse(req, '/api/sessions', Response.json({ session }, { status: 201 }));
+}
+async function handlePostTask(context, req) {
+    const body = await context.parseJsonBody(req);
+    if (body instanceof Response)
+        return body;
+    const task = body.task;
+    if (!task || typeof task !== 'string' || task.trim() === '') {
+        return Response.json({ error: 'Missing required field: task (non-empty string)' }, { status: 400 });
+    }
+    const model = typeof body.model === 'string' ? body.model : undefined;
+    const tools = Array.isArray(body.tools) ? body.tools.filter((t) => typeof t === 'string') : undefined;
+    const wantsSharedSession = typeof body.sessionId === 'string' || typeof body.routeId === 'string' || typeof body.surfaceKind === 'string';
+    if (wantsSharedSession) {
+        const submission = await context.sessionBroker.submitMessage({
+            sessionId: typeof body.sessionId === 'string' ? body.sessionId : undefined,
+            routeId: typeof body.routeId === 'string' ? body.routeId : undefined,
+            surfaceKind: typeof body.surfaceKind === 'string' ? body.surfaceKind : 'web',
+            surfaceId: typeof body.surfaceId === 'string' ? body.surfaceId : 'surface:web',
+            externalId: typeof body.externalId === 'string' ? body.externalId : undefined,
+            threadId: typeof body.threadId === 'string' ? body.threadId : undefined,
+            userId: typeof body.userId === 'string' ? body.userId : undefined,
+            displayName: typeof body.displayName === 'string' ? body.displayName : undefined,
+            title: typeof body.title === 'string' ? body.title : undefined,
+            body: task.trim(),
+            metadata: typeof body.metadata === 'object' && body.metadata !== null ? body.metadata : {},
+            ...(typeof body.routing === 'object' && body.routing !== null ? { routing: body.routing } : {}),
+        });
+        if (submission.mode === 'continued-live') {
+            return context.recordApiResponse(req, '/task', Response.json({
+                acknowledged: true,
+                mode: submission.mode,
+                sessionId: submission.session.id,
+                agentId: submission.activeAgentId ?? null,
+                inputId: submission.input.id,
+            }, { status: 202 }));
+        }
+        if (submission.mode === 'queued-follow-up') {
+            return context.recordApiResponse(req, '/task', Response.json({
+                acknowledged: true,
+                mode: submission.mode,
+                sessionId: submission.session.id,
+                agentId: submission.activeAgentId ?? null,
+                inputId: submission.input.id,
+            }, { status: 202 }));
+        }
+        if (submission.mode === 'rejected') {
+            return context.recordApiResponse(req, '/task', Response.json({
+                acknowledged: false,
+                mode: submission.mode,
+                sessionId: submission.session.id,
+                inputId: submission.input.id,
+            }, { status: 409 }));
+        }
+        const sessionSpawn = context.trySpawnAgent({
+            mode: 'spawn',
+            task: submission.task,
+            ...(model !== undefined || submission.input.routing?.modelId ? { model: model ?? submission.input.routing?.modelId } : {}),
+            ...(tools !== undefined || submission.input.routing?.tools ? { tools: tools ?? [...(submission.input.routing?.tools ?? [])] } : {}),
+            ...(submission.input.routing?.providerId ? { provider: submission.input.routing.providerId } : {}),
+            ...(submission.input.routing?.executionIntent ? { executionIntent: submission.input.routing.executionIntent } : {}),
+        }, 'DaemonServer.handlePostTask.sharedSession', submission.session.id);
+        if (sessionSpawn instanceof Response)
+            return sessionSpawn;
+        await context.sessionBroker.bindAgent(submission.session.id, sessionSpawn.id);
+        context.queueSurfaceReplyFromBinding(submission.routeBinding, {
+            agentId: sessionSpawn.id,
+            task,
+            sessionId: submission.session.id,
+        });
+        return context.recordApiResponse(req, '/task', Response.json({
+            acknowledged: true,
+            mode: submission.mode,
+            sessionId: submission.session.id,
+            agentId: sessionSpawn.id,
+            status: sessionSpawn.status,
+        }, { status: 202 }));
+    }
+    const spawnResult = context.trySpawnAgent({
+        mode: 'spawn',
+        task,
+        ...(model !== undefined && { model }),
+        ...(tools !== undefined && { tools }),
+        ...(typeof body.routing === 'object'
+            && body.routing !== null
+            && typeof body.routing.executionIntent === 'object'
+            && body.routing.executionIntent !== null
+            ? {
+                executionIntent: body.routing.executionIntent,
+            }
+            : {}),
+    }, 'DaemonServer', typeof body.sessionId === 'string' ? body.sessionId : undefined);
+    if (spawnResult instanceof Response)
+        return spawnResult;
+    return context.recordApiResponse(req, '/task', Response.json({
+        acknowledged: true,
+        agentId: spawnResult.id,
+        status: spawnResult.status,
+        task: spawnResult.task,
+        model: spawnResult.model ?? null,
+        tools: spawnResult.tools,
+    }, { status: 202 }));
+}
+async function handleGetSharedSession(context, sessionId) {
+    await context.sessionBroker.start();
+    const session = context.sessionBroker.getSession(sessionId);
+    if (!session) {
+        return Response.json({ error: 'Unknown shared session' }, { status: 404 });
+    }
+    return Response.json({
+        session,
+        messages: context.sessionBroker.getMessages(sessionId, 100),
+    });
+}
+async function handleSharedSessionLifecycle(context, sessionId, action) {
+    await context.sessionBroker.start();
+    const session = action === 'close'
+        ? await context.sessionBroker.closeSession(sessionId)
+        : await context.sessionBroker.reopenSession(sessionId);
+    return session
+        ? Response.json({ session })
+        : Response.json({ error: 'Unknown shared session' }, { status: 404 });
+}
+async function handleGetSharedSessionMessages(context, sessionId, url) {
+    await context.sessionBroker.start();
+    const session = context.sessionBroker.getSession(sessionId);
+    if (!session) {
+        return Response.json({ error: 'Unknown shared session' }, { status: 404 });
+    }
+    const limit = Number(url.searchParams.get('limit') ?? 100);
+    return Response.json({
+        session,
+        messages: context.sessionBroker.getMessages(sessionId, limit),
+    });
+}
+async function handleGetSharedSessionInputs(context, sessionId, url) {
+    await context.sessionBroker.start();
+    const session = context.sessionBroker.getSession(sessionId);
+    if (!session) {
+        return Response.json({ error: 'Unknown shared session' }, { status: 404 });
+    }
+    const limit = Number(url.searchParams.get('limit') ?? 100);
+    return Response.json({
+        session,
+        inputs: context.sessionBroker.getInputs(sessionId, limit),
+    });
+}
+async function handlePostSharedSessionMessage(context, sessionId, req) {
+    const body = await context.parseJsonBody(req);
+    if (body instanceof Response)
+        return body;
+    const message = readSharedSessionMessageBody(body);
+    if (!message) {
+        return Response.json({ error: 'Missing shared session message body' }, { status: 400 });
+    }
+    const submission = await context.sessionBroker.submitMessage(buildSharedSessionMessageInput(sessionId, body, message));
+    return await respondToSessionSubmission(context, req, submission, message, `/api/sessions/${sessionId}/messages`, 'DaemonServer.handlePostSharedSessionMessage', {
+        context: `shared-session:${submission.session.id}`,
+    });
+}
+async function handlePostSharedSessionSteer(context, sessionId, req) {
+    const body = await context.parseJsonBody(req);
+    if (body instanceof Response)
+        return body;
+    const message = readSharedSessionMessageBody(body);
+    if (!message) {
+        return Response.json({ error: 'Missing shared session steer body' }, { status: 400 });
+    }
+    const submission = await context.sessionBroker.steerMessage({
+        ...buildSharedSessionMessageInput(sessionId, body, message),
+        ...(body.allowSpawnFallback === true ? { allowSpawnFallback: true } : {}),
+    });
+    return await respondToSessionSubmission(context, req, submission, message, `/api/sessions/${sessionId}/steer`, 'DaemonServer.handlePostSharedSessionSteer', {
+        context: `shared-session:${submission.session.id}`,
+    });
+}
+async function handlePostSharedSessionFollowUp(context, sessionId, req) {
+    const body = await context.parseJsonBody(req);
+    if (body instanceof Response)
+        return body;
+    const message = readSharedSessionMessageBody(body);
+    if (!message) {
+        return Response.json({ error: 'Missing shared session follow-up body' }, { status: 400 });
+    }
+    const submission = await context.sessionBroker.followUpMessage(buildSharedSessionMessageInput(sessionId, body, message));
+    return await respondToSessionSubmission(context, req, submission, message, `/api/sessions/${sessionId}/follow-up`, 'DaemonServer.handlePostSharedSessionFollowUp', {
+        context: `shared-session:${submission.session.id}`,
+    });
+}
+async function handleCancelSharedSessionInput(context, sessionId, inputId) {
+    await context.sessionBroker.start();
+    const input = await context.sessionBroker.cancelInput(sessionId, inputId);
+    if (!input) {
+        return Response.json({ error: 'Unknown shared session input' }, { status: 404 });
+    }
+    return Response.json({ input });
+}
+function handleGetRuntimeTask(context, taskId) {
+    const task = context.runtimeStore?.getState().tasks.tasks.get(taskId);
+    if (!task) {
+        return Response.json({ error: 'Unknown runtime task' }, { status: 404 });
+    }
+    return Response.json({ task });
+}
+function readSharedSessionMessageBody(body) {
+    return typeof body.message === 'string'
+        ? body.message.trim()
+        : typeof body.body === 'string'
+            ? body.body.trim()
+            : typeof body.text === 'string'
+                ? body.text.trim()
+                : '';
+}
+function buildSharedSessionMessageInput(sessionId, body, message) {
+    return {
+        sessionId,
+        surfaceKind: typeof body.surfaceKind === 'string' ? body.surfaceKind : 'web',
+        surfaceId: typeof body.surfaceId === 'string' ? body.surfaceId : 'surface:web',
+        ...(typeof body.externalId === 'string' ? { externalId: body.externalId } : {}),
+        ...(typeof body.threadId === 'string' ? { threadId: body.threadId } : {}),
+        ...(typeof body.userId === 'string' ? { userId: body.userId } : {}),
+        ...(typeof body.displayName === 'string' ? { displayName: body.displayName } : {}),
+        ...(typeof body.title === 'string' ? { title: body.title } : {}),
+        ...(typeof body.routeId === 'string' ? { routeId: body.routeId } : {}),
+        body: message,
+        ...(typeof body.metadata === 'object' && body.metadata !== null ? { metadata: body.metadata } : {}),
+        ...(typeof body.routing === 'object' && body.routing !== null ? { routing: body.routing } : {}),
+    };
+}
+async function respondToSessionSubmission(context, req, submission, taskText, path, logLabel, spawnOptions = {}) {
+    if (submission.mode === 'continued-live' || submission.mode === 'queued-follow-up') {
+        return context.recordApiResponse(req, path, Response.json({
+            session: submission.session,
+            message: submission.userMessage ?? null,
+            input: submission.input,
+            mode: submission.mode,
+            agentId: submission.activeAgentId ?? null,
+        }, { status: 202 }));
+    }
+    if (submission.mode === 'rejected') {
+        return context.recordApiResponse(req, path, Response.json({
+            session: submission.session,
+            message: submission.userMessage ?? null,
+            input: submission.input,
+            mode: submission.mode,
+        }, { status: 409 }));
+    }
+    const spawnResult = context.trySpawnAgent({
+        mode: 'spawn',
+        task: submission.task,
+        ...(spawnOptions.context ? { context: spawnOptions.context } : {}),
+        ...(spawnOptions.model ?? submission.input.routing?.modelId ? { model: spawnOptions.model ?? submission.input.routing?.modelId } : {}),
+        ...(spawnOptions.provider ?? submission.input.routing?.providerId ? { provider: spawnOptions.provider ?? submission.input.routing?.providerId } : {}),
+        ...(spawnOptions.tools ?? submission.input.routing?.tools ? { tools: [...(spawnOptions.tools ?? submission.input.routing?.tools ?? [])] } : {}),
+        ...(spawnOptions.executionIntent ?? submission.input.routing?.executionIntent
+            ? { executionIntent: spawnOptions.executionIntent ?? submission.input.routing?.executionIntent }
+            : {}),
+    }, logLabel, submission.session.id);
+    if (spawnResult instanceof Response)
+        return spawnResult;
+    await context.sessionBroker.bindAgent(submission.session.id, spawnResult.id);
+    context.queueSurfaceReplyFromBinding(submission.routeBinding, {
+        agentId: spawnResult.id,
+        task: taskText,
+        sessionId: submission.session.id,
+    });
+    return context.recordApiResponse(req, path, Response.json({
+        session: context.sessionBroker.getSession(submission.session.id),
+        message: submission.userMessage ?? null,
+        input: {
+            ...submission.input,
+            state: 'spawned',
+            activeAgentId: spawnResult.id,
+        },
+        mode: submission.mode,
+        agentId: spawnResult.id,
+    }, { status: 202 }));
+}
+function handleRuntimeTaskAction(context, taskId, action, _req) {
+    if (!context.runtimeStore || !context.runtimeDispatch) {
+        return Response.json({ error: 'Runtime store unavailable' }, { status: 503 });
+    }
+    const task = context.runtimeStore.getState().tasks.tasks.get(taskId);
+    if (!task) {
+        return Response.json({ error: 'Unknown runtime task' }, { status: 404 });
+    }
+    if (action === 'cancel') {
+        if (task.kind === 'agent' && task.owner) {
+            context.agentManager.cancel(task.owner);
+        }
+        context.runtimeDispatch.transitionRuntimeTask(taskId, 'cancelled', {
+            endedAt: Date.now(),
+            error: 'Cancelled via control plane',
+        }, 'daemon.server.tasks.cancel');
+        return Response.json({ task: context.runtimeStore.getState().tasks.tasks.get(taskId) });
+    }
+    if (action === 'retry') {
+        if (task.kind !== 'agent') {
+            return Response.json({ error: 'Retry is only implemented for agent tasks' }, { status: 400 });
+        }
+        const spawnResult = context.trySpawnAgent({
+            mode: 'spawn',
+            task: task.description ?? task.title ?? '',
+        }, 'DaemonServer.handleRuntimeTaskAction');
+        if (spawnResult instanceof Response)
+            return spawnResult;
+        context.runtimeDispatch.transitionRuntimeTask(taskId, 'queued', {
+            startedAt: undefined,
+            endedAt: undefined,
+            error: undefined,
+            result: undefined,
+        }, 'daemon.server.tasks.retry');
+        return Response.json({
+            retried: true,
+            task: context.runtimeStore.getState().tasks.tasks.get(taskId),
+            agentId: spawnResult.id,
+        });
+    }
+    return Response.json({ error: 'Unsupported task action' }, { status: 400 });
+}
+function handleGetTaskStatus(context, agentId) {
+    const record = context.agentManager.getStatus(agentId);
+    if (!record) {
+        return Response.json({ error: `Agent not found: ${agentId}` }, { status: 404 });
+    }
+    if (record.status === 'completed' || record.status === 'failed' || record.status === 'cancelled') {
+        context.syncFinishedAgentTask(record);
+    }
+    const durationMs = record.completedAt !== undefined
+        ? record.completedAt - record.startedAt
+        : Date.now() - record.startedAt;
+    return Response.json({
+        agentId: record.id,
+        task: record.task,
+        status: record.status,
+        model: record.model ?? null,
+        tools: record.tools,
+        durationMs,
+        toolCallCount: record.toolCallCount,
+        progress: record.progress ?? null,
+        error: record.error ?? null,
+    });
+}

package/dist/_internal/daemon/sessions.d.ts

@@ -0,0 +1,3 @@
+import type { DaemonApiRouteHandlers } from './context.js';
+export declare function dispatchSessionRoutes(req: Request, handlers: Pick<DaemonApiRouteHandlers, 'getIntegrationSessions' | 'createSharedSession' | 'getSharedSession' | 'closeSharedSession' | 'reopenSharedSession' | 'getSharedSessionMessages' | 'postSharedSessionMessage' | 'getSharedSessionInputs' | 'postSharedSessionSteer' | 'postSharedSessionFollowUp' | 'cancelSharedSessionInput'>): Promise<Response | null>;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/_internal/daemon/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../../src/_internal/daemon/sessions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE3D,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,IAAI,CACZ,sBAAsB,EACpB,wBAAwB,GACxB,qBAAqB,GACrB,kBAAkB,GAClB,oBAAoB,GACpB,qBAAqB,GACrB,0BAA0B,GAC1B,0BAA0B,GAC1B,wBAAwB,GACxB,wBAAwB,GACxB,2BAA2B,GAC3B,0BAA0B,CAC7B,GACA,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAqC1B"}

package/dist/_internal/daemon/sessions.js

@@ -0,0 +1,37 @@
+export async function dispatchSessionRoutes(req, handlers) {
+    const url = new URL(req.url);
+    const { pathname } = url;
+    const method = req.method;
+    if (pathname === '/api/sessions' && method === 'GET')
+        return handlers.getIntegrationSessions();
+    if (pathname === '/api/sessions' && method === 'POST')
+        return handlers.createSharedSession(req);
+    const sharedSessionMatch = pathname.match(/^\/api\/sessions\/([^/]+)$/);
+    if (sharedSessionMatch && method === 'GET')
+        return handlers.getSharedSession(sharedSessionMatch[1]);
+    const sharedSessionCloseMatch = pathname.match(/^\/api\/sessions\/([^/]+)\/(close|reopen)$/);
+    if (sharedSessionCloseMatch && method === 'POST') {
+        return sharedSessionCloseMatch[2] === 'close'
+            ? handlers.closeSharedSession(sharedSessionCloseMatch[1])
+            : handlers.reopenSharedSession(sharedSessionCloseMatch[1]);
+    }
+    const sharedSessionMessagesMatch = pathname.match(/^\/api\/sessions\/([^/]+)\/messages$/);
+    if (sharedSessionMessagesMatch && method === 'GET')
+        return handlers.getSharedSessionMessages(sharedSessionMessagesMatch[1], url);
+    if (sharedSessionMessagesMatch && method === 'POST')
+        return handlers.postSharedSessionMessage(sharedSessionMessagesMatch[1], req);
+    const sharedSessionInputsMatch = pathname.match(/^\/api\/sessions\/([^/]+)\/inputs$/);
+    if (sharedSessionInputsMatch && method === 'GET')
+        return handlers.getSharedSessionInputs(sharedSessionInputsMatch[1], url);
+    const sharedSessionSteerMatch = pathname.match(/^\/api\/sessions\/([^/]+)\/steer$/);
+    if (sharedSessionSteerMatch && method === 'POST')
+        return handlers.postSharedSessionSteer(sharedSessionSteerMatch[1], req);
+    const sharedSessionFollowUpMatch = pathname.match(/^\/api\/sessions\/([^/]+)\/follow-up$/);
+    if (sharedSessionFollowUpMatch && method === 'POST')
+        return handlers.postSharedSessionFollowUp(sharedSessionFollowUpMatch[1], req);
+    const sharedSessionCancelInputMatch = pathname.match(/^\/api\/sessions\/([^/]+)\/inputs\/([^/]+)\/cancel$/);
+    if (sharedSessionCancelInputMatch && method === 'POST') {
+        return handlers.cancelSharedSessionInput(sharedSessionCancelInputMatch[1], sharedSessionCancelInputMatch[2]);
+    }
+    return null;
+}

package/dist/_internal/daemon/system-route-types.d.ts

@@ -0,0 +1,124 @@
+import type { JsonRecord } from './route-helpers.js';
+export type DaemonApiClientKind = 'web' | 'slack' | 'discord' | 'ntfy' | 'webhook' | 'telegram' | 'google-chat' | 'signal' | 'whatsapp' | 'imessage' | 'msteams' | 'bluebubbles' | 'mattermost' | 'matrix' | 'daemon';
+export type AutomationRouteBindingKind = string;
+export type AutomationSurfaceKind = string;
+export type AutomationSessionPolicy = string;
+export type AutomationThreadPolicy = string;
+export type AutomationDeliveryGuarantee = string;
+export type WatcherKind = string;
+export interface ConfigManagerLike {
+    get(key: string): unknown;
+    getAll(): Record<string, unknown>;
+    setDynamic(key: string, value: unknown): void;
+}
+export interface IntegrationApprovalSnapshotSourceLike {
+    getApprovalSnapshot(): unknown;
+}
+export interface PlatformServiceManagerLike {
+    status(): Record<string, unknown>;
+    install(): unknown;
+    start(): unknown;
+    stop(): unknown;
+    restart(): unknown;
+    uninstall(): unknown;
+}
+export interface RouteBindingRecordInput {
+    readonly id?: string;
+    readonly kind: AutomationRouteBindingKind;
+    readonly surfaceKind: AutomationSurfaceKind;
+    readonly surfaceId: string;
+    readonly externalId: string;
+    readonly sessionPolicy?: AutomationSessionPolicy;
+    readonly threadPolicy?: AutomationThreadPolicy;
+    readonly deliveryGuarantee?: AutomationDeliveryGuarantee;
+    readonly threadId?: string;
+    readonly channelId?: string;
+    readonly sessionId?: string | null;
+    readonly jobId?: string | null;
+    readonly runId?: string | null;
+    readonly title?: string;
+    readonly metadata: Record<string, unknown>;
+}
+export interface RouteBindingPatchInput {
+    readonly sessionPolicy?: AutomationSessionPolicy;
+    readonly threadPolicy?: AutomationThreadPolicy;
+    readonly deliveryGuarantee?: AutomationDeliveryGuarantee;
+    readonly threadId?: string;
+    readonly channelId?: string;
+    readonly sessionId?: string | null;
+    readonly jobId?: string | null;
+    readonly runId?: string | null;
+    readonly title?: string;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface RouteBindingManagerLike {
+    listBindings(): readonly unknown[];
+    upsertBinding(input: RouteBindingRecordInput): Promise<unknown>;
+    patchBinding(bindingId: string, input: RouteBindingPatchInput): Promise<unknown | null>;
+    removeBinding(bindingId: string): Promise<boolean>;
+}
+export interface WatcherSourceRecord {
+    readonly id: string;
+    readonly kind: string;
+    readonly label: string;
+    readonly enabled: boolean;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly metadata: Record<string, unknown>;
+}
+export interface WatcherRecord {
+    readonly id: string;
+    readonly label: string;
+    readonly kind: WatcherKind;
+    readonly source: WatcherSourceRecord;
+    readonly intervalMs?: number;
+    readonly metadata: Record<string, unknown>;
+}
+export interface WatcherRegistryLike {
+    list(): readonly unknown[];
+    removeWatcher(watcherId: string): boolean;
+    registerWatcher(input: {
+        readonly id: string;
+        readonly label: string;
+        readonly kind: WatcherKind;
+        readonly source: WatcherSourceRecord;
+        readonly intervalMs: number;
+        readonly metadata: Record<string, unknown>;
+        readonly run?: () => string;
+    }): WatcherRecord;
+    getWatcher(watcherId: string): WatcherRecord | null;
+    startWatcher(watcherId: string): WatcherRecord | null;
+    stopWatcher(watcherId: string, reason: string): WatcherRecord | null;
+    runWatcherNow(watcherId: string): Promise<WatcherRecord | null>;
+}
+export interface ApprovalBrokerLike {
+    claimApproval(approvalId: string, actor: string, actorSurface: string, note?: string): Promise<unknown | null>;
+    cancelApproval(approvalId: string, actor: string, actorSurface: string, note?: string): Promise<unknown | null>;
+    resolveApproval(approvalId: string, input: {
+        readonly approved: boolean;
+        readonly remember: boolean;
+        readonly actor: string;
+        readonly actorSurface: string;
+        readonly note?: string;
+    }): Promise<unknown | null>;
+}
+export interface DaemonSystemRouteContext {
+    readonly approvalBroker: ApprovalBrokerLike;
+    readonly configManager: ConfigManagerLike;
+    readonly integrationHelpers: IntegrationApprovalSnapshotSourceLike | null;
+    readonly inspectInboundTls: (surface: 'controlPlane' | 'httpListener') => unknown;
+    readonly inspectOutboundTls: () => unknown;
+    readonly isValidConfigKey: (key: string) => boolean;
+    readonly parseJsonBody: (req: Request) => Promise<JsonRecord | Response>;
+    readonly parseOptionalJsonBody: (req: Request) => Promise<JsonRecord | null | Response>;
+    readonly platformServiceManager: PlatformServiceManagerLike;
+    readonly recordApiResponse: (req: Request, path: string, response: Response, clientKind?: DaemonApiClientKind) => Response;
+    readonly requireAdmin: (req: Request) => Response | null;
+    readonly requireAuthenticatedSession: (req: Request) => {
+        username: string;
+        roles: readonly string[];
+    } | null;
+    readonly routeBindings: RouteBindingManagerLike;
+    readonly watcherRegistry: WatcherRegistryLike;
+}
+//# sourceMappingURL=system-route-types.d.ts.map

package/dist/_internal/daemon/system-route-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-route-types.d.ts","sourceRoot":"","sources":["../../../src/_internal/daemon/system-route-types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,MAAM,mBAAmB,GAC3B,KAAK,GACL,OAAO,GACP,SAAS,GACT,MAAM,GACN,SAAS,GACT,UAAU,GACV,aAAa,GACb,QAAQ,GACR,UAAU,GACV,UAAU,GACV,SAAS,GACT,aAAa,GACb,YAAY,GACZ,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAChD,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAC3C,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAC7C,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAC5C,MAAM,MAAM,2BAA2B,GAAG,MAAM,CAAC;AACjD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,qCAAqC;IACpD,mBAAmB,IAAI,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,IAAI,OAAO,CAAC;IACnB,KAAK,IAAI,OAAO,CAAC;IACjB,IAAI,IAAI,OAAO,CAAC;IAChB,OAAO,IAAI,OAAO,CAAC;IACnB,SAAS,IAAI,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACjD,QAAQ,CAAC,YAAY,CAAC,EAAE,sBAAsB,CAAC;IAC/C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,2BAA2B,CAAC;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACjD,QAAQ,CAAC,YAAY,CAAC,EAAE,sBAAsB,CAAC;IAC/C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,2BAA2B,CAAC;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,IAAI,SAAS,OAAO,EAAE,CAAC;IACnC,aAAa,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChE,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACxF,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,IAAI,SAAS,OAAO,EAAE,CAAC;IAC3B,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1C,eAAe,CAAC,KAAK,EAAE;QACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;QAC3B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;QACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;KAC7B,GAAG,aAAa,CAAC;IAClB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAAC;IACpD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAAC;IACtD,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAAC;IACrE,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC/G,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAChH,eAAe,CACb,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE;QACL,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;KACxB,GACA,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAAC;IAC5C,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,kBAAkB,EAAE,qCAAqC,GAAG,IAAI,CAAC;IAC1E,QAAQ,CAAC,iBAAiB,EAAE,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,KAAK,OAAO,CAAC;IAClF,QAAQ,CAAC,kBAAkB,EAAE,MAAM,OAAO,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACpD,QAAQ,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,UAAU,GAAG,QAAQ,CAAC,CAAC;IACzE,QAAQ,CAAC,qBAAqB,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,GAAG,QAAQ,CAAC,CAAC;IACxF,QAAQ,CAAC,sBAAsB,EAAE,0BAA0B,CAAC;IAC5D,QAAQ,CAAC,iBAAiB,EAAE,CAC1B,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,EAClB,UAAU,CAAC,EAAE,mBAAmB,KAC7B,QAAQ,CAAC;IACd,QAAQ,CAAC,YAAY,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,QAAQ,GAAG,IAAI,CAAC;IACzD,QAAQ,CAAC,2BAA2B,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9G,QAAQ,CAAC,aAAa,EAAE,uBAAuB,CAAC;IAChD,QAAQ,CAAC,eAAe,EAAE,mBAAmB,CAAC;CAC/C"}

package/dist/_internal/daemon/system-route-types.js

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

package/dist/_internal/daemon/system-routes.d.ts

@@ -0,0 +1,4 @@
+import type { DaemonApiRouteHandlers } from './context.js';
+import type { DaemonSystemRouteContext } from './system-route-types.js';
+export declare function createDaemonSystemRouteHandlers(context: DaemonSystemRouteContext, request: Request): Pick<DaemonApiRouteHandlers, 'getWatchers' | 'postWatcher' | 'patchWatcher' | 'watcherAction' | 'deleteWatcher' | 'getServiceStatus' | 'installService' | 'startService' | 'stopService' | 'restartService' | 'uninstallService' | 'getRouteBindings' | 'postRouteBinding' | 'patchRouteBinding' | 'deleteRouteBinding' | 'getApprovals' | 'approvalAction' | 'getConfig' | 'postConfig'>;
+//# sourceMappingURL=system-routes.d.ts.map

package/dist/_internal/daemon/system-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-routes.d.ts","sourceRoot":"","sources":["../../../src/_internal/daemon/system-routes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAG3D,OAAO,KAAK,EAMV,wBAAwB,EAEzB,MAAM,yBAAyB,CAAC;AAEjC,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,wBAAwB,EACjC,OAAO,EAAE,OAAO,GACf,IAAI,CACL,sBAAsB,EACpB,aAAa,GACb,aAAa,GACb,cAAc,GACd,eAAe,GACf,eAAe,GACf,kBAAkB,GAClB,gBAAgB,GAChB,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,GAClB,kBAAkB,GAClB,mBAAmB,GACnB,oBAAoB,GACpB,cAAc,GACd,gBAAgB,GAChB,WAAW,GACX,YAAY,CACf,CAwJA"}