One Codebase. 13 Platforms. Zero Compromises.

1explain-to-my-boss/
2  definition.ts    ← what it does
3  repository.ts    ← how it does it
4  route.ts         ← makes it exist everywhere
5  widget.tsx       ← custom React UI (optional)
6  widget.cli.tsx   ← custom terminal UI (optional)

1// This single array controls where the feature appears
2allowedRoles: [
3  CLI_OFF,         // blocks the CLI
4  MCP_VISIBLE,     // opts into the MCP tool list
5  REMOTE_SKILL,    // puts it in the agent skill file
6  PRODUCTION_OFF,  // disables it in prod
7]

1// definition.ts
2const { POST } = createEndpoint({
3  scopedTranslation,
4  aliases: [EXPLAIN_TO_MY_BOSS_ALIAS],
5  method: Methods.POST,
6  path: ["explain", "to-my-boss"],
7  title: "post.title",
8  description: "post.description",
9  icon: "sparkles",
10  category: "endpointCategories.ai",
11  allowedRoles: [UserRole.CUSTOMER, UserRole.ADMIN] as const,
12  fields: objectField(scopedTranslation, {
13    type: WidgetType.CONTAINER,
14    usage: { request: "data", response: true },
15    children: {
16      decision: requestField(scopedTranslation, {
17        type: WidgetType.FORM_FIELD,
18        fieldType: FieldDataType.TEXTAREA,
19        label: "post.fields.decision.label",
20        description: "post.fields.decision.description",
21        schema: z.string().min(1).max(2000),
22        columns: 12,
23      }),
24      justification: responseField(scopedTranslation, {
25        type: WidgetType.TEXT,
26        content: "post.fields.justification.content",
27        schema: z.string(),
28      }),
29    },
30  }),
31  errorTypes: { /* ... all 9 required error types ... */ },
32  successTypes: { title: "post.success.title", description: "post.success.description" },
33  examples: { requests: { default: { decision: "Migrate to Bun" } }, responses: { default: { justification: "..." } } },
34});

1// repository.ts
2// Returns ResponseType<T> - never throws
3export async function explainToMyBoss(
4  data: { decision: string },
5  logger: Logger,
6): Promise<ResponseType<{ justification: string }>> {
7  const result = await ai.generateText({
8    prompt: buildPrompt(data.decision),
9  });
10  if (!result.text) {
11    return fail({ message: "AI returned empty response", errorType: EndpointErrorTypes.SERVER_ERROR });
12  }
13  return success({ justification: result.text });
14}

1// route.ts
2import { endpointsHandler } from "@/app/api/[locale]/system/unified-interface/shared/endpoints/route/multi";
3import { Methods } from "@/app/api/[locale]/system/unified-interface/shared/types/enums";
4import definitions from "./definition";
5import { explainToMyBoss } from "./repository";
6
7export const { POST, tools } = endpointsHandler({
8  endpoint: definitions,
9  [Methods.POST]: { handler: ({ data, logger }) => explainToMyBoss(data, logger) },
10});