Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
/**
* Durable consumer-side adapter for federated audio jobs.
*
* The retry/idempotency/cancel/integrity machinery lives in the shared
* executor (services/federatedMedia/remoteExecutor.js); this module supplies
* only the audio-specific parts: the persisted marker shape, the
* privacy-safe prompt rendering, and where the verified WAV lands.
*/
import { z } from 'zod';
import { PATHS } from '../../lib/fileUtils.js';
import {
FEDERATED_MEDIA_WIRE_VERSION,
federatedMediaAudioProfileSchema,
renderFederatedMediaAudioPrompt,
} from '../../lib/federatedMediaWire.js';
import { federatedMediaJobRoutingSchema } from '../../lib/validation.js';
import { createRemoteMediaExecutor, remoteMediaError } from '../federatedMedia/remoteExecutor.js';
import { audioGenEvents } from './events.js';
const remoteMediaMarkerSchema = z.object({
wireVersion: z.literal(FEDERATED_MEDIA_WIRE_VERSION),
peerId: z.string().uuid(),
reconcile: z.boolean().optional(),
cancelRequested: z.boolean().optional(),
// Set by the unattended (standing) router, never by an interactive render.
// Optional so a marker already queued by an older build still validates; its
// absence means "interactive", which is the correct reading of history.
standingRoute: z.boolean().optional(),
profile: federatedMediaAudioProfileSchema,
// The free-form STYLE prompt is deliberately absent from persisted routing
// state: the adapter renders a fixed-vocabulary instrumental prompt from the
// profile immediately before submission, so hand-edited queue state cannot
// smuggle personal prose into the prompt field.
//
// Lyrics are the exception, and are stored — they are the conditioning a
// lyrical render exists to carry, and no fixed vocabulary encodes them
// without discarding them (ADR
// docs/decisions/2026-08-22-federated-media-input-assets.md rule 2). Optional
// so a marker queued by an older build still validates; absent means the
// instrumental render that build was the only one able to route.
lyrics: z.string().max(50_000).optional(),
request: federatedMediaJobRoutingSchema,
}).passthrough();
const executor = createRemoteMediaExecutor({
kind: 'audio',
label: 'audio',
events: audioGenEvents,
markerSchema: remoteMediaMarkerSchema,
buildRequest(marker) {
const prompt = renderFederatedMediaAudioPrompt(marker.profile);
if (!prompt) {
throw remoteMediaError('Remote audio job has an invalid privacy-safe profile', {
code: 'MEDIA_PROVIDER_AUDIO_PROFILE_INVALID',
});
}
// No explicit `kind` on the wire: an already-deployed audio-only provider
// validates this body against a strict schema that predates the field and
// would reject it. The provider defaults a kind-less body to 'audio'.
//
// `lyrics` is omitted entirely when the marker has none, rather than sent
// as `''`. An older provider's strict schema knows the field but refuses
// any truthy value, so an empty string still validates there — but omitting
// it keeps the request hash (and therefore idempotent replay) identical to
// what a pre-lyrics build submitted for the same instrumental job.
return {
...marker.request,
prompt,
...(marker.lyrics ? { lyrics: marker.lyrics } : {}),
};
},
// PATHS is read per job (not captured at module load) so a test that swaps
// the music directory still sees its own temp root.
resolveDestination: ({ jobId }) => ({ dir: PATHS.music, filename: `music-gen-${jobId}.wav` }),
finalize: async ({ filename, request, remoteJob }) => ({
filename,
durationSec: remoteJob.result.durationSec ?? request.durationSec ?? null,
engine: remoteJob.result.engine ?? request.engine,
modelId: remoteJob.result.modelId ?? request.modelId,
}),
});
export const generateAudio = executor.run;
export const cancel = executor.cancel;
export const __configureRemoteAudioForTests = executor.configureForTests;
export const __resetRemoteAudioForTests = executor.resetForTests;