wulf-pulse/app/api/rmm/executions/route.ts
lorentz 1112a06afe feat: RMM Overshell, IT Glue audit/write-back, LogLift, link-aware bundles, dashboard overhaul
- RMM Overshell (migration 077): admin page, dispatch UI, executor/worker, target
  resolver, script registry (AD/DHCP/DNS/event-log/services/software/network/loglift)
- LogLift evidence pipeline (migration 078): upload webhook, B2 storage client,
  receiver/matcher, EventLogCollector PowerShell script
- IT Glue audit + write-back (migrations 075, 076): asset-audit runner, ticket
  xrefs, applications/configurations browse pages + apply/revert/audit endpoints
- Link-aware analyzer bundles (migration 073) + provider toggle (migration 074):
  link-discovery service, OpenRouter LLM provider, related-tickets/itglue-suggestion
  panels, analyze-bundle endpoint
- Endpoint data model + device-link reconciliation (migrations 079, 080): conflicts
  admin page, reconciler service, resolve endpoints
- Dashboard overhaul: integration-health service + alerts, overview/health endpoints
- Permissions: add itglue + rmm scopes; middleware: public /api/rmm/loglift route

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-03 07:13:18 -04:00

118 lines
3.9 KiB
TypeScript

/**
* GET /api/rmm/executions
* List recent executions. Filters: companyId, scriptId, status,
* assetType, assetId. requireAuth() — admin sees all by default.
*
* POST /api/rmm/executions
* Body: { scriptId, target: { type: 'site_anchor', companyId } |
* { type: 'asset_self', deviceUid, hostname?, companyId?, assetType?, assetId? },
* triggeredByAuditId? }
* Requires rmm.execute. Queues a fresh execution.
*/
import { NextRequest, NextResponse } from 'next/server';
import { z } from 'zod';
import { requireAuth, requirePermission } from '@/lib/auth-utils';
import {
listExecutions,
type RmmExecutionStatus,
} from '@/lib/services/rmm/persistence';
import { queueExecution } from '@/lib/services/rmm/executor';
// Side-effect import: starts the worker once per process.
import '@/lib/services/rmm/worker';
const PostBody = z.object({
scriptId: z.string().min(1),
target: z.discriminatedUnion('type', [
z.object({
type: z.literal('site_anchor'),
companyId: z.union([z.string(), z.number()]),
}),
z.object({
type: z.literal('asset_self'),
deviceUid: z.string().min(1),
hostname: z.string().nullable().optional(),
companyId: z.union([z.string(), z.number()]).nullable().optional(),
assetType: z.enum(['flexible_asset', 'configuration']).optional(),
assetId: z.union([z.string(), z.number()]).optional(),
}),
]),
triggeredByAuditId: z.string().uuid().nullable().optional(),
});
const ALLOWED_STATUSES: ReadonlyArray<RmmExecutionStatus> = [
'queued',
'running',
'complete',
'failed',
'timeout',
];
export async function GET(request: NextRequest) {
const { error } = await requireAuth();
if (error) return error;
const url = new URL(request.url);
const limit = Number(url.searchParams.get('limit') ?? 100);
const offset = Number(url.searchParams.get('offset') ?? 0);
const companyIdParam = url.searchParams.get('companyId');
const scriptIdParam = url.searchParams.get('scriptId');
const statusParam = url.searchParams.get('status');
const assetTypeParam = url.searchParams.get('assetType');
const assetIdParam = url.searchParams.get('assetId');
const status =
statusParam && ALLOWED_STATUSES.includes(statusParam as RmmExecutionStatus)
? (statusParam as RmmExecutionStatus)
: undefined;
const assetType =
assetTypeParam === 'flexible_asset' || assetTypeParam === 'configuration'
? assetTypeParam
: undefined;
const executions = await listExecutions({
limit,
offset,
companyId: companyIdParam ?? undefined,
scriptId: scriptIdParam ?? undefined,
status,
assetType,
assetId: assetIdParam ?? undefined,
});
return NextResponse.json({ executions });
}
export async function POST(request: NextRequest) {
const { session, error } = await requirePermission('rmm', 'execute');
if (error) return error;
const userId = (session?.user as { id: string } | undefined)?.id ?? null;
const body = await request.json().catch(() => ({}));
const parsed = PostBody.safeParse(body);
if (!parsed.success) {
return NextResponse.json(
{ error: 'Invalid body', details: parsed.error.issues },
{ status: 400 }
);
}
try {
const result = await queueExecution({
scriptId: parsed.data.scriptId,
target: parsed.data.target,
performedByUserId: userId,
triggeredByAuditId: parsed.data.triggeredByAuditId ?? null,
});
return NextResponse.json(result);
} catch (err) {
const message = err instanceof Error ? err.message : String(err);
// Rate-limit failures + bad targets read as 400; everything else 500.
const isClient =
message.includes('rate limit') ||
message.includes('No Wulf Nurse') ||
message.includes('Unknown script') ||
message.includes('expects target_type');
return NextResponse.json(
{ error: 'Could not queue execution', message },
{ status: isClient ? 400 : 500 }
);
}
}