@pellux/goodvibes-daemon-sdk 0.18.3 → 0.30.0

package/dist/runtime-session-routes.js

@@ -1,3 +1,10 @@
+import { randomUUID } from 'node:crypto';
+import { readBoundedPositiveInteger } from './route-helpers.js';
+const DEFAULT_LIST_LIMIT = 100;
+const MAX_LIST_LIMIT = 500;
+function readBoundedLimit(url, key = 'limit') {
+    return readBoundedPositiveInteger(url.searchParams.get(key), DEFAULT_LIST_LIMIT, MAX_LIST_LIMIT);
+}
 export function createDaemonRuntimeSessionRouteHandlers(context) {
     return {
         createSharedSession: async (request) => handleCreateSharedSession(context, request),
@@ -14,6 +21,7 @@ export function createDaemonRuntimeSessionRouteHandlers(context) {
         getRuntimeTask: (taskId) => handleGetRuntimeTask(context, taskId),
         runtimeTaskAction: (taskId, action, request) => handleRuntimeTaskAction(context, taskId, action, request),
         getTaskStatus: (agentId) => handleGetTaskStatus(context, agentId),
+        getSharedSessionEvents: (sessionId, request) => handleGetSharedSessionEvents(context, sessionId, request),
     };
 }
 async function handleCreateSharedSession(context, req) {
@@ -171,7 +179,7 @@ async function handleGetSharedSessionMessages(context, sessionId, url) {
     if (!session) {
         return Response.json({ error: 'Unknown shared session' }, { status: 404 });
     }
-    const limit = Number(url.searchParams.get('limit') ?? 100);
+    const limit = readBoundedLimit(url);
     return Response.json({
         session,
         messages: context.sessionBroker.getMessages(sessionId, limit),
@@ -183,25 +191,100 @@ async function handleGetSharedSessionInputs(context, sessionId, url) {
     if (!session) {
         return Response.json({ error: 'Unknown shared session' }, { status: 404 });
     }
-    const limit = Number(url.searchParams.get('limit') ?? 100);
+    const limit = readBoundedLimit(url);
     return Response.json({
         session,
         inputs: context.sessionBroker.getInputs(sessionId, limit),
     });
 }
+/**
+ * Handle POST /api/sessions/:sessionId/messages.
+ *
+ * Accepts `{body}` in the request payload and returns 400 when it is absent or empty.
+ */
 async function handlePostSharedSessionMessage(context, sessionId, req) {
     const body = await context.parseJsonBody(req);
     if (body instanceof Response)
         return body;
+    // Validate kind field. Ordinary session messages default to conversation
+    // routing; callers must explicitly opt into kind='task' for agent/WRFC work.
+    const kind = body.kind === undefined ? 'message' : body.kind;
+    if (kind !== 'task' && kind !== 'message' && kind !== 'followup') {
+        return Response.json({ error: `Invalid kind '${String(kind)}'. Accepted values: 'task' | 'message' | 'followup'`, code: 'INVALID_KIND' }, { status: 400 });
+    }
     const message = readSharedSessionMessageBody(body);
     if (!message) {
         return Response.json({ error: 'Missing shared session message body' }, { status: 400 });
     }
+    // kind='followup' — always queues/spawns a follow-up turn via followUpMessage()
+    if (kind === 'followup') {
+        const followUpSubmission = await context.sessionBroker.followUpMessage(buildSharedSessionMessageInput(sessionId, body, message));
+        return await respondToSessionSubmission(context, req, followUpSubmission, message, `/api/sessions/${sessionId}/messages`, 'DaemonServer.handlePostSharedSessionMessage.followup', {
+            context: `shared-session:${followUpSubmission.session.id}`,
+        });
+    }
+    // kind='message' — companion main-chat send. Persist + publish COMPANION_MESSAGE_RECEIVED
+    // on the runtime bus; TUI's bootstrap-core subscriber delegates to
+    // orchestrator.handleUserInput() which fires a real LLM turn (same entry as TUI input
+    // box). Turn events stream to both TUI and companion over SSE automatically.
+    // Deliberately short-circuits BEFORE sessionBroker.submitMessage() to avoid the
+    // buildContinuationTask WRFC engineer-chain spawn path.
+    if (kind === 'message') {
+        const session = context.sessionBroker.getSession(sessionId);
+        if (!session) {
+            return Response.json({ error: 'Unknown shared session', code: 'SESSION_NOT_FOUND' }, { status: 404 });
+        }
+        if (session.status === 'closed') {
+            return Response.json({ error: 'Session is closed', code: 'SESSION_CLOSED' }, { status: 409 });
+        }
+        const messageId = randomUUID();
+        const timestamp = Date.now();
+        // Persist the companion message to the session log so GET /api/sessions/:id/messages
+        // returns it and the TUI can render it.
+        await context.sessionBroker.appendCompanionMessage(sessionId, {
+            messageId,
+            body: message,
+            source: 'companion-followup',
+            timestamp,
+        });
+        // Also notify the TUI's in-process subscriber via the conversation follow-up event.
+        context.publishConversationFollowup(sessionId, {
+            messageId,
+            body: message,
+            source: 'companion-followup',
+            timestamp,
+        });
+        // Return immediately. appendCompanionMessage persists the message and
+        // publishConversationFollowup emits COMPANION_MESSAGE_RECEIVED on the runtime bus.
+        // The TUI's bootstrap-core.ts COMPANION_MESSAGE_RECEIVED subscriber delegates to
+        // orchestrator.handleUserInput(), which adds the user message to the conversation
+        // view and fires a real LLM turn whose events stream to both TUI and companion SSE.
+        // The { routedTo: 'conversation' } shape signals the companion app that the message
+        // was received and persisted (isConversationRouteResult check).
+        return context.recordApiResponse(req, `/api/sessions/${sessionId}/messages`, Response.json({
+            messageId,
+            routedTo: 'conversation',
+            sessionId,
+        }, { status: 202 }));
+    }
     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}`,
     });
 }
+/**
+ * Handle GET /api/sessions/:id/events — creates a session-scoped SSE stream
+ * for the companion app to receive turn events (STREAM_DELTA, TURN_COMPLETED,
+ * etc.) and agent events from the shared session.
+ */
+async function handleGetSharedSessionEvents(context, sessionId, req) {
+    await context.sessionBroker.start();
+    const session = context.sessionBroker.getSession(sessionId);
+    if (!session) {
+        return Response.json({ error: 'Unknown shared session', code: 'SESSION_NOT_FOUND' }, { status: 404 });
+    }
+    return context.openSessionEventStream(req, sessionId);
+}
 async function handlePostSharedSessionSteer(context, sessionId, req) {
     const body = await context.parseJsonBody(req);
     if (body instanceof Response)
@@ -237,6 +320,12 @@ async function handleCancelSharedSessionInput(context, sessionId, inputId) {
     if (!input) {
         return Response.json({ error: 'Unknown shared session input' }, { status: 404 });
     }
+    // F17: cancelInput returns the entry unchanged when state is not 'queued'.
+    // Return 409 so callers know the cancel was a no-op (e.g. already spawned).
+    const inputRecord = input;
+    if (inputRecord.state !== 'queued' && inputRecord.state !== 'cancelled') {
+        return Response.json({ error: `Cannot cancel input in state '${inputRecord.state}'`, code: 'CANCEL_NOT_ALLOWED', input }, { status: 409 });
+    }
     return Response.json({ input });
 }
 function handleGetRuntimeTask(context, taskId) {
@@ -246,14 +335,17 @@ function handleGetRuntimeTask(context, taskId) {
     }
     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()
-                : '';
+/**
+ * Extract the message body from an incoming POST body.
+ *
+ * F13 normalization: accepts the canonical 'body' field.
+ * The caller must check for an empty result and return 400.
+ *
+ * @param body - Parsed JSON body from the request.
+ * @returns Trimmed message string, or '' if none of the accepted fields are present.
+ */
+export function readSharedSessionMessageBody(body) {
+    return typeof body.body === 'string' ? body.body.trim() : '';
 }
 function buildSharedSessionMessageInput(sessionId, body, message) {
     return {

package/dist/sessions.d.ts

@@ -1,3 +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>;
+import type { DaemonSessionRouteHandlers } from './context.js';
+export declare function dispatchSessionRoutes(req: Request, handlers: DaemonSessionRouteHandlers): Promise<Response | null>;
 //# sourceMappingURL=sessions.d.ts.map

package/dist/sessions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"AACA,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"}
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAE/D,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,0BAA0B,GACnC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAwC1B"}

package/dist/sessions.js

@@ -33,5 +33,8 @@ export async function dispatchSessionRoutes(req, handlers) {
     if (sharedSessionCancelInputMatch && method === 'POST') {
         return handlers.cancelSharedSessionInput(sharedSessionCancelInputMatch[1], sharedSessionCancelInputMatch[2]);
     }
+    const sharedSessionEventsMatch = pathname.match(/^\/api\/sessions\/([^/]+)\/events$/);
+    if (sharedSessionEventsMatch && method === 'GET')
+        return handlers.getSharedSessionEvents(sharedSessionEventsMatch[1], req);
     return null;
 }

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

@@ -102,6 +102,23 @@ export interface ApprovalBrokerLike {
         readonly note?: string;
     }): Promise<unknown | null>;
 }
+export interface WorkspaceSwapManagerLike {
+    getCurrentWorkingDir(): string;
+    requestSwap(newWorkingDir: string): Promise<{
+        ok: true;
+        previous: string;
+        current: string;
+    } | {
+        ok: false;
+        code: 'WORKSPACE_BUSY';
+        reason: string;
+        retryAfter: number;
+    } | {
+        ok: false;
+        code: 'INVALID_PATH';
+        reason: string;
+    }>;
+}
 export interface DaemonSystemRouteContext {
     readonly approvalBroker: ApprovalBrokerLike;
     readonly configManager: ConfigManagerLike;
@@ -119,6 +136,8 @@ export interface DaemonSystemRouteContext {
         roles: readonly string[];
     } | null;
     readonly routeBindings: RouteBindingManagerLike;
+    /** Manages runtime.workingDir swaps. Null when workspace swapping is not available. */
+    readonly swapManager: WorkspaceSwapManagerLike | null;
     readonly watcherRegistry: WatcherRegistryLike;
 }
 //# sourceMappingURL=system-route-types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"system-route-types.d.ts","sourceRoot":"","sources":["../src/system-route-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"system-route-types.d.ts","sourceRoot":"","sources":["../src/system-route-types.ts"],"names":[],"mappings":"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"}

package/dist/system-routes.d.ts

@@ -1,4 +1,4 @@
-import type { DaemonApiRouteHandlers } from './context.js';
+import type { DaemonSystemRouteHandlers } 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'>;
+export declare function createDaemonSystemRouteHandlers(context: DaemonSystemRouteContext, request: Request): DaemonSystemRouteHandlers;
 //# sourceMappingURL=system-routes.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"system-routes.d.ts","sourceRoot":"","sources":["../src/system-routes.ts"],"names":[],"mappings":"AACA,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"}
+{"version":3,"file":"system-routes.d.ts","sourceRoot":"","sources":["../src/system-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAG9D,OAAO,KAAK,EAMV,wBAAwB,EAEzB,MAAM,yBAAyB,CAAC;AAEjC,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,wBAAwB,EACjC,OAAO,EAAE,OAAO,GACf,yBAAyB,CA6K3B"}

package/dist/system-routes.js

@@ -157,6 +157,24 @@ export function createDaemonSystemRouteHandlers(context, request) {
             if (!key || typeof key !== 'string') {
                 return Response.json({ error: 'Missing or invalid key' }, { status: 400 });
             }
+            // Special-case: runtime.workingDir is handled by the workspace swap manager.
+            if (key === 'runtime.workingDir') {
+                if (!context.swapManager) {
+                    return Response.json({ error: 'Workspace swapping is not available in this daemon configuration.' }, { status: 400 });
+                }
+                if (typeof value !== 'string' || !value.trim()) {
+                    return Response.json({ error: 'runtime.workingDir value must be a non-empty string path.', code: 'INVALID_PATH' }, { status: 400 });
+                }
+                const result = await context.swapManager.requestSwap(value);
+                if (result.ok) {
+                    return Response.json({ success: true, key, value: result.current, previous: result.previous });
+                }
+                if (result.code === 'WORKSPACE_BUSY') {
+                    return Response.json({ error: result.reason, code: 'WORKSPACE_BUSY', retryAfter: result.retryAfter }, { status: 409 });
+                }
+                // INVALID_PATH
+                return Response.json({ error: result.reason, code: 'INVALID_PATH' }, { status: 400 });
+            }
             if (!context.isValidConfigKey(key)) {
                 return Response.json({ error: 'Invalid config key' }, { status: 400 });
             }

package/dist/tasks.d.ts

@@ -1,3 +1,3 @@
-import type { DaemonApiRouteHandlers } from './context.js';
-export declare function dispatchTaskRoutes(req: Request, handlers: Pick<DaemonApiRouteHandlers, 'getIntegrationTasks' | 'getRuntimeTask' | 'runtimeTaskAction' | 'getTaskStatus' | 'postTask'>): Promise<Response | null>;
+import type { DaemonTaskRouteHandlers } from './context.js';
+export declare function dispatchTaskRoutes(req: Request, handlers: DaemonTaskRouteHandlers): Promise<Response | null>;
 //# sourceMappingURL=tasks.d.ts.map

package/dist/tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../src/tasks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE3D,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,IAAI,CACZ,sBAAsB,EACpB,qBAAqB,GACrB,gBAAgB,GAChB,mBAAmB,GACnB,eAAe,GACf,UAAU,CACb,GACA,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAqB1B"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../src/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAE5D,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAqB1B"}

package/dist/telemetry-routes.d.ts

@@ -1,4 +1,4 @@
-import type { DaemonApiRouteHandlers } from './context.js';
+import type { DaemonTelemetryRouteHandlers } from './context.js';
 import { type AuthenticatedPrincipal } from './http-policy.js';
 import type { RuntimeEventDomain } from '@pellux/goodvibes-contracts';
 type TelemetrySeverity = 'debug' | 'info' | 'warn' | 'error';
@@ -35,10 +35,33 @@ interface TelemetryApiLike {
     buildOtlpLogDocument(filter: TelemetryFilter, view: TelemetryViewMode): unknown;
     buildOtlpMetricDocument(): unknown;
 }
+/**
+ * Ingest sink — receives parsed OTLP records forwarded by the POST receivers.
+ * When null (no ingest sink wired), the route still accepts and acknowledges
+ * payloads (to keep client exporters happy) but discards the data.
+ */
+interface TelemetryIngestSink {
+    /** Ingest a batch of log records from an OTLP ExportLogsServiceRequest. */
+    ingestLogs(payload: Record<string, unknown>): void;
+    /** Ingest a batch of trace spans from an OTLP ExportTraceServiceRequest. */
+    ingestTraces(payload: Record<string, unknown>): void;
+    /** Ingest a batch of metric data points from an OTLP ExportMetricsServiceRequest. */
+    ingestMetrics(payload: Record<string, unknown>): void;
+}
 interface TelemetryRouteContext {
     readonly telemetryApi: TelemetryApiLike | null;
     readonly resolveAuthenticatedPrincipal: (req: Request) => AuthenticatedPrincipal | null;
+    /**
+     * Sink for OTLP POST receivers. Must be provided by the caller.
+     * In production `DaemonHttpRouter` this is the `TelemetryApiService` instance
+     * which stores ingested records in its bounded event buffer (default 500
+     * records) and makes them observable via GET /api/v1/telemetry/events.
+     * Pass `null` only in test/stub contexts where ingestion is intentionally
+     * a no-op — the receivers still return 200 to keep OTLP exporters happy but
+     * discard the payload.
+     */
+    readonly ingestSink: TelemetryIngestSink | null;
 }
-export declare function createDaemonTelemetryRouteHandlers(context: TelemetryRouteContext): Pick<DaemonApiRouteHandlers, 'getTelemetrySnapshot' | 'getTelemetryEvents' | 'getTelemetryErrors' | 'getTelemetryTraces' | 'getTelemetryMetrics' | 'createTelemetryEventStream' | 'getTelemetryOtlpTraces' | 'getTelemetryOtlpLogs' | 'getTelemetryOtlpMetrics'>;
+export declare function createDaemonTelemetryRouteHandlers(context: TelemetryRouteContext): DaemonTelemetryRouteHandlers;
 export {};
 //# sourceMappingURL=telemetry-routes.d.ts.map

package/dist/telemetry-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry-routes.d.ts","sourceRoot":"","sources":["../src/telemetry-routes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"telemetry-routes.d.ts","sourceRoot":"","sources":["../src/telemetry-routes.ts"],"names":[],"mappings":"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"}

package/dist/telemetry-routes.js

@@ -1,9 +1,15 @@
 import { buildMissingScopeBody } from './http-policy.js';
-function parseNumber(value) {
+import { decodeOtlpProtobuf } from './otlp-protobuf.js';
+import { DaemonErrorCategory } from '@pellux/goodvibes-errors';
+import { readBoundedPositiveInteger, readOptionalBoundedInteger } from './route-helpers.js';
+const MAX_TELEMETRY_TIMESTAMP_MS = Date.UTC(2100, 0, 1);
+function parseLimit(value) {
     if (value === null || value.trim().length === 0)
         return undefined;
-    const parsed = Number(value);
-    return Number.isFinite(parsed) ? parsed : undefined;
+    return readBoundedPositiveInteger(value, 100, 1_000);
+}
+function parseTimestampMillis(value) {
+    return readOptionalBoundedInteger(value, 0, MAX_TELEMETRY_TIMESTAMP_MS);
 }
 function parseCsv(value) {
     if (!value)
@@ -23,27 +29,101 @@ function parseView(value) {
     return value === 'safe' || value === 'raw' ? value : undefined;
 }
 function buildFilter(url) {
+    const limit = parseLimit(url.searchParams.get('limit'));
+    const since = parseTimestampMillis(url.searchParams.get('since'));
+    const until = parseTimestampMillis(url.searchParams.get('until'));
+    const domains = parseCsv(url.searchParams.get('domains'));
+    const eventTypes = parseCsv(url.searchParams.get('types'));
+    const severity = parseSeverity(url.searchParams.get('severity'));
+    const view = parseView(url.searchParams.get('view'));
     return {
-        ...(parseNumber(url.searchParams.get('limit')) !== undefined ? { limit: parseNumber(url.searchParams.get('limit')) } : {}),
-        ...(parseNumber(url.searchParams.get('since')) !== undefined ? { since: parseNumber(url.searchParams.get('since')) } : {}),
-        ...(parseNumber(url.searchParams.get('until')) !== undefined ? { until: parseNumber(url.searchParams.get('until')) } : {}),
-        ...(parseCsv(url.searchParams.get('domains')) ? { domains: parseCsv(url.searchParams.get('domains')) } : {}),
-        ...(parseCsv(url.searchParams.get('types')) ? { eventTypes: parseCsv(url.searchParams.get('types')) } : {}),
-        ...(parseSeverity(url.searchParams.get('severity')) ? { severity: parseSeverity(url.searchParams.get('severity')) } : {}),
+        ...(limit !== undefined ? { limit } : {}),
+        ...(since !== undefined ? { since } : {}),
+        ...(until !== undefined ? { until } : {}),
+        ...(domains ? { domains } : {}),
+        ...(eventTypes ? { eventTypes } : {}),
+        ...(severity ? { severity } : {}),
         ...(url.searchParams.get('traceId') ? { traceId: url.searchParams.get('traceId') ?? undefined } : {}),
         ...(url.searchParams.get('sessionId') ? { sessionId: url.searchParams.get('sessionId') ?? undefined } : {}),
         ...(url.searchParams.get('turnId') ? { turnId: url.searchParams.get('turnId') ?? undefined } : {}),
         ...(url.searchParams.get('agentId') ? { agentId: url.searchParams.get('agentId') ?? undefined } : {}),
         ...(url.searchParams.get('taskId') ? { taskId: url.searchParams.get('taskId') ?? undefined } : {}),
         ...(url.searchParams.get('cursor') ? { cursor: url.searchParams.get('cursor') ?? undefined } : {}),
-        ...(parseView(url.searchParams.get('view')) ? { view: parseView(url.searchParams.get('view')) } : {}),
+        ...(view ? { view } : {}),
     };
 }
+// ---------------------------------------------------------------------------
+// OTLP ingest helpers
+// ---------------------------------------------------------------------------
+/** Max ingest payload (4 MiB) — reject larger bodies with 413 */
+const OTLP_INGEST_MAX_BODY_BYTES = 4 * 1024 * 1024;
+/** Accepted content-types for OTLP/HTTP ingest. */
+const OTLP_JSON_CONTENT_TYPE = 'application/json';
+const OTLP_PROTOBUF_CONTENT_TYPES = new Set(['application/x-protobuf', 'application/protobuf']);
+const OTLP_PARTIAL_SUCCESS_KEYS = {
+    logs: 'partialSuccess',
+    traces: 'partialSuccess',
+    metrics: 'partialSuccess',
+};
+/**
+ * Validate and parse an OTLP HTTP ingest request body.
+ * Returns a parsed JSON Record on success, or a Response (error) on failure.
+ *
+ * Protocol: OTLP/HTTP spec §4.2 — supports JSON and binary protobuf service
+ * requests for logs, traces, and metrics.
+ */
+async function parseOtlpBody(req, kind) {
+    const contentType = (req.headers.get('content-type') ?? '').toLowerCase().split(';')[0].trim();
+    const acceptsJson = contentType === OTLP_JSON_CONTENT_TYPE;
+    const acceptsProtobuf = OTLP_PROTOBUF_CONTENT_TYPES.has(contentType);
+    if (!acceptsJson && !acceptsProtobuf) {
+        return Response.json({
+            error: `Unsupported Content-Type '${contentType}' for OTLP ingest`,
+            code: 'UNSUPPORTED_MEDIA_TYPE',
+            category: DaemonErrorCategory.BAD_REQUEST,
+            hint: `Use '${OTLP_JSON_CONTENT_TYPE}' or 'application/x-protobuf'.`,
+        }, { status: 415 });
+    }
+    const raw = await req.arrayBuffer();
+    if (raw.byteLength > OTLP_INGEST_MAX_BODY_BYTES) {
+        return Response.json({
+            error: `OTLP ingest payload too large (${raw.byteLength} > ${OTLP_INGEST_MAX_BODY_BYTES} bytes)`,
+            code: 'PAYLOAD_TOO_LARGE',
+            category: DaemonErrorCategory.BAD_REQUEST,
+        }, { status: 413 });
+    }
+    if (acceptsProtobuf) {
+        try {
+            return decodeOtlpProtobuf(kind, new Uint8Array(raw));
+        }
+        catch (error) {
+            void error;
+            return Response.json({ error: 'OTLP ingest body is not valid protobuf', code: 'INVALID_PAYLOAD', category: DaemonErrorCategory.BAD_REQUEST }, { status: 400 });
+        }
+    }
+    try {
+        const text = new TextDecoder().decode(raw);
+        const parsed = JSON.parse(text);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            return Response.json({ error: 'OTLP ingest body must be a JSON object', code: 'INVALID_PAYLOAD', category: DaemonErrorCategory.BAD_REQUEST }, { status: 400 });
+        }
+        return parsed;
+    }
+    catch (error) {
+        void error;
+        return Response.json({ error: 'OTLP ingest body is not valid JSON', code: 'INVALID_PAYLOAD', category: DaemonErrorCategory.BAD_REQUEST }, { status: 400 });
+    }
+}
+function otlpIngestSuccess(kind) {
+    // Per OTLP/HTTP spec: respond with ExportXxxServiceResponse shape.
+    // partialSuccess omitted when empty (all records accepted).
+    return Response.json({ [OTLP_PARTIAL_SUCCESS_KEYS[kind]]: {} });
+}
 function unavailable() {
     return Response.json({
         error: 'Telemetry API unavailable',
         code: 'TELEMETRY_UNAVAILABLE',
-        category: 'service',
+        category: DaemonErrorCategory.SERVICE,
         source: 'runtime',
         recoverable: true,
         hint: 'Start the daemon runtime and ensure the runtime store is available before reading telemetry.',
@@ -54,7 +134,7 @@ function invalidCursor(error) {
     return Response.json({
         error: error instanceof Error ? error.message : 'Invalid telemetry cursor',
         code: 'INVALID_CURSOR',
-        category: 'bad_request',
+        category: DaemonErrorCategory.BAD_REQUEST,
         source: 'runtime',
         recoverable: false,
         hint: 'Use the nextCursor returned by the previous telemetry page, or omit cursor to start from the newest records.',
@@ -67,7 +147,7 @@ function authenticateTelemetryRequest(context, req, requestedView) {
         return Response.json({
             error: 'Authentication required for telemetry access',
             code: 'AUTH_REQUIRED',
-            category: 'authentication',
+            category: DaemonErrorCategory.AUTHENTICATION,
             source: 'runtime',
             recoverable: false,
             hint: 'Authenticate with the operator shared token or an authenticated user session before calling telemetry APIs.',
@@ -79,7 +159,7 @@ function authenticateTelemetryRequest(context, req, requestedView) {
         return Response.json({
             error: missingRead.error,
             code: 'MISSING_SCOPE',
-            category: 'authorization',
+            category: DaemonErrorCategory.AUTHORIZATION,
             source: 'permission',
             recoverable: false,
             hint: 'Use a token or session with the read:telemetry scope, or elevate to an admin/shared-token session.',
@@ -92,7 +172,7 @@ function authenticateTelemetryRequest(context, req, requestedView) {
         return Response.json({
             error: 'Raw telemetry view requires elevated telemetry scope',
             code: 'MISSING_SCOPE',
-            category: 'authorization',
+            category: DaemonErrorCategory.AUTHORIZATION,
             source: 'permission',
             recoverable: false,
             hint: 'Use an admin/shared-token session or a token granted read:telemetry-sensitive to access raw telemetry payloads.',
@@ -223,5 +303,41 @@ export function createDaemonTelemetryRouteHandlers(context) {
                 return access;
             return Response.json(context.telemetryApi.buildOtlpMetricDocument());
         },
+        // -------------------------------------------------------------------------
+        // OTLP POST ingest receivers
+        // -------------------------------------------------------------------------
+        postTelemetryOtlpLogs: async (req) => {
+            const auth = context.resolveAuthenticatedPrincipal(req);
+            if (!auth) {
+                return Response.json({ error: 'Authentication required for OTLP ingest', code: 'AUTH_REQUIRED', category: DaemonErrorCategory.AUTHENTICATION, status: 401 }, { status: 401 });
+            }
+            const bodyOrErr = await parseOtlpBody(req, 'logs');
+            if (bodyOrErr instanceof Response)
+                return bodyOrErr;
+            context.ingestSink?.ingestLogs(bodyOrErr);
+            return otlpIngestSuccess('logs');
+        },
+        postTelemetryOtlpTraces: async (req) => {
+            const auth = context.resolveAuthenticatedPrincipal(req);
+            if (!auth) {
+                return Response.json({ error: 'Authentication required for OTLP ingest', code: 'AUTH_REQUIRED', category: DaemonErrorCategory.AUTHENTICATION, status: 401 }, { status: 401 });
+            }
+            const bodyOrErr = await parseOtlpBody(req, 'traces');
+            if (bodyOrErr instanceof Response)
+                return bodyOrErr;
+            context.ingestSink?.ingestTraces(bodyOrErr);
+            return otlpIngestSuccess('traces');
+        },
+        postTelemetryOtlpMetrics: async (req) => {
+            const auth = context.resolveAuthenticatedPrincipal(req);
+            if (!auth) {
+                return Response.json({ error: 'Authentication required for OTLP ingest', code: 'AUTH_REQUIRED', category: DaemonErrorCategory.AUTHENTICATION, status: 401 }, { status: 401 });
+            }
+            const bodyOrErr = await parseOtlpBody(req, 'metrics');
+            if (bodyOrErr instanceof Response)
+                return bodyOrErr;
+            context.ingestSink?.ingestMetrics(bodyOrErr);
+            return otlpIngestSuccess('metrics');
+        },
     };
 }