置くだけで、
動く。

import {
  ApplicationCommandOptionType,
  Command,
  type ChatInputCommandInteraction,
} from "@cc-discord-framework/core";

@Command.define({
  description: "AIに質問します(会話履歴は使いません)。",
  options: [
    {
      type: ApplicationCommandOptionType.String,
      name: "prompt",
      description: "聞きたいこと",
      required: true,
    },
  ],
})
export class AskCommand extends Command {
  override async chatInputRun(interaction: ChatInputCommandInteraction) {
    // defer・ストリーミング表示・長文の分割・失敗時の表示は reply() の担当。
    await this.services.ai.reply(interaction, {
      prompt: interaction.options.getString("prompt", true),
    });
  }
}

import { chunk, paginate, type Page } from "@cc-discord-framework/utils";
import { Command, type ChatInputCommandInteraction } from "@cc-discord-framework/core";

const PAGE_SIZE = 20;

@Command.define({ description: "コマンド一覧を表示します。" })
export class HelpCommand extends Command {
  override async chatInputRun(interaction: ChatInputCommandInteraction) {
    const lines = this.container.stores
      .get("commands")
      .map((command) => `**/${command.name}** — ${command.description}`)
      .sort();

    const pages: Page[] = chunk(lines, PAGE_SIZE).map((body, page, all) =>
      // utils プラグインの this.services.ui — 色は Bot 全体のテーマから。
      this.services.ui
        .info(body.join("\n"))
        .setTitle("コマンド一覧")
        .setFooter({ text: `${page + 1}/${all.length}ページ・全${lines.length}コマンド` }),
    );

    await paginate(interaction, { pages, ephemeral: true });
  }
}

import { ActivityType } from "@cc-discord-framework/core";
import { Task } from "@cc-discord-framework/utils";

/** 公式 utils プラグインが追加する Task 種別のコンポーネント。 */
@Task.define({ every: "5m", runOnStart: true })
export class PresenceTask extends Task {
  override run() {
    this.client.user?.setPresence({
      activities: [{ type: ActivityType.Playing, name: "/help" }],
    });
  }
}

import { defineConfig, GatewayIntentBits } from "@cc-discord-framework/core";
import { music } from "@cc-discord-framework/music";
import { musicSources } from "@cc-discord-framework/music-sources";
import { env } from "./_env.js";

export default defineConfig({
  priority: 50,
  intents: [
    // 音楽再生に必要(ボイスチャンネルの出入りを追うため)。
    GatewayIntentBits.GuildVoiceStates,
  ],
  plugins: [
    // キュー・再生制御の this.services.audio(/play などは src/commands/)。
    music(),
    // YouTube と SoundCloud を音源として追加(music より後に置く)。
    musicSources({
      soundcloud: { clientId: env.soundcloudClientId },
    }),
  ],
});

import { AiTool, type AiToolContext } from "@cc-discord-framework/ai";
import { z } from "zod";

const input = z.object({
  キュー: z.boolean().optional().describe("待機中の曲を題名の一覧で返すかどうか"),
});

@AiTool.define({
  description:
    "このサーバーで再生中の曲と、待機中の曲の状況を返します。音楽の再生状況を聞かれたら使ってください。",
  inputSchema: input,
  // 再生キューはサーバー単位なので、DM からの呼び出しでは使わせない。
  guildOnly: true,
})
export class NowPlayingTool extends AiTool<z.infer<typeof input>> {
  override execute({ キュー = false }: z.infer<typeof input>, context: AiToolContext) {
    const queue = context.guildId === null ? null : this.services.audio.queue(context.guildId);
    if (!queue?.current) return { 再生中: null, 待機中: 0 };

    return {
      再生中: { 題名: queue.current.title, 演者: queue.current.author },
      待機中: キュー ? queue.tracks.map((track) => track.title) : queue.tracks.length,
    };
  }
}