@mulmochat-plugin/quiz 0.1.0

package/README.md

@@ -0,0 +1,159 @@
+# MulmoChat Plugin Quiz
+
+MulmoChat用のクイズプラグイン。複数選択式のクイズをユーザーに提示します。
+
+## 概要
+
+このプラグインは、MulmoChatのプラグインシステムのリファレンス実装です。外部依存がなく、サーバー通信も不要なシンプルな構造のため、新しいプラグインを作成する際のテンプレートとして使用できます。
+
+## インストール
+
+### MulmoChatへの追加
+
+1. プラグインをビルド:
+```bash
+cd MulmoChatPluginQuiz
+yarn install
+yarn build
+yarn pack
+```
+
+2. MulmoChatの`package.json`に依存関係を追加:
+```json
+{
+  "dependencies": {
+    "mulmochat-plugin-quiz": "file:../MulmoChatPluginQuiz/mulmochat-plugin-quiz-v0.1.0.tgz"
+  }
+}
+```
+
+3. MulmoChatの`src/tools/index.ts`でインポート:
+```typescript
+import type { ToolPlugin } from "./types";
+
+// Quiz plugin from npm package
+import { QuizPlugin as QuizPluginImport } from "mulmochat-plugin-quiz";
+const QuizPlugin = QuizPluginImport as { plugin: ToolPlugin };
+
+// pluginListに追加
+const pluginList = [
+  // ... other plugins
+  QuizPlugin,
+];
+```
+
+4. MulmoChatで依存関係を再インストール:
+```bash
+cd MulmoChat
+yarn install --force
+```
+
+## 開発
+
+### セットアップ
+
+```bash
+yarn install
+```
+
+### 開発サーバー
+
+```bash
+yarn dev
+```
+
+http://localhost:5173/ でデモページが表示されます。
+
+### ビルド
+
+```bash
+yarn build
+```
+
+### 型チェック
+
+```bash
+yarn typecheck
+```
+
+## プラグイン構造
+
+```
+MulmoChatPluginQuiz/
+├── src/
+│   ├── index.ts          # エクスポート定義
+│   ├── plugin.ts         # プラグイン実装
+│   ├── types.ts          # 型定義
+│   ├── views/
+│   │   └── QuizView.vue  # メインビューコンポーネント
+│   └── previews/
+│       └── QuizPreview.vue  # サイドバープレビュー
+├── demo/                 # 開発用デモページ
+├── package.json
+├── vite.config.ts
+└── tsconfig.json
+```
+
+## 新しいプラグインの作成
+
+このリポジトリをベースに新しいプラグインを作成する手順:
+
+1. リポジトリをコピー:
+```bash
+cp -r MulmoChatPluginQuiz MulmoChatPluginYourPlugin
+cd MulmoChatPluginYourPlugin
+rm -rf .git node_modules dist *.tgz
+git init
+```
+
+2. `package.json`を編集:
+   - `name`: `mulmochat-plugin-yourplugin`
+   - `description`: プラグインの説明
+
+3. `src/plugin.ts`を編集:
+   - `TOOL_DEFINITION`: ツール名、説明、パラメータを定義
+   - `execute`: ツール実行ロジックを実装
+   - 必要に応じて型定義を追加
+
+4. `src/views/YourView.vue`を作成:
+   - メイン表示コンポーネント
+   - Props: `selectedResult`, `sendTextMessage`
+   - Emit: `updateResult`
+
+5. `src/previews/YourPreview.vue`を作成:
+   - サイドバー用のプレビューコンポーネント
+   - Props: `result`
+
+6. `src/index.ts`でエクスポートを更新
+
+7. `demo/App.vue`をプラグインに合わせて更新
+
+## ToolPlugin インターフェース
+
+```typescript
+interface ToolPlugin<T, J, A> {
+  toolDefinition: {
+    type: "function";
+    name: string;
+    description: string;
+    parameters?: {
+      type: "object";
+      properties: Record<string, JsonSchemaProperty>;
+      required: string[];
+    };
+  };
+  execute: (context: ToolContext, args: A) => Promise<ToolResult<T, J>>;
+  generatingMessage: string;
+  isEnabled: (startResponse?: StartApiResponse | null) => boolean;
+  viewComponent?: Component;
+  previewComponent?: Component;
+  // Optional
+  systemPrompt?: string;
+  fileUpload?: FileUploadConfig;
+  config?: ToolPluginConfig;
+}
+```
+
+## ライセンス
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,3 @@
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("vue"),k={class:"quiz-container"},E={key:0,class:"quiz-content"},b={key:0,class:"quiz-title"},z={class:"questions-list"},N={class:"question-text"},V={class:"question-number"},B={class:"choices-list"},S=["name","value","onUpdate:modelValue"],Q={class:"choice-text"},D={class:"choice-letter"},$={class:"submit-section"},C=["disabled"],A={class:"progress-text"},T=e.defineComponent({__name:"QuizView",props:{selectedResult:{},sendTextMessage:{type:Function}},emits:["updateResult"],setup(l,{emit:u}){const t=l,i=u,s=e.ref(null),o=e.ref([]);e.watch(()=>t.selectedResult,n=>{n?.toolName==="putQuestions"&&n.jsonData&&(s.value=n.jsonData,n.viewState?.userAnswers?o.value=n.viewState.userAnswers:o.value=new Array(s.value.questions.length).fill(null))},{immediate:!0}),e.watch(o,n=>{if(t.selectedResult&&n){const d={...t.selectedResult,viewState:{userAnswers:n}};i("updateResult",d)}},{deep:!0});const r=e.computed(()=>o.value.filter(n=>n!==null).length),p=e.computed(()=>s.value&&r.value===s.value.questions.length);function q(n,d){return o.value[n]===d?"choice-selected":"choice-default"}function f(){if(!s.value||!p.value)return;const d=`Here are my answers:
+${o.value.map((c,a)=>{if(c===null)return null;const m=a+1,h=String.fromCharCode(65+c),v=s.value.questions[a].choices[c];return`Q${m}: ${h} - ${v}`}).filter(c=>c!==null).join(`
+`)}`;t.sendTextMessage(d)}return(n,d)=>(e.openBlock(),e.createElementBlock("div",k,[s.value?(e.openBlock(),e.createElementBlock("div",E,[s.value.title?(e.openBlock(),e.createElementBlock("h2",b,e.toDisplayString(s.value.title),1)):e.createCommentVNode("",!0),e.createElementVNode("div",z,[(e.openBlock(!0),e.createElementBlock(e.Fragment,null,e.renderList(s.value.questions,(c,a)=>(e.openBlock(),e.createElementBlock("div",{key:a,class:"question-card"},[e.createElementVNode("div",N,[e.createElementVNode("span",V,e.toDisplayString(a+1)+".",1),e.createTextVNode(" "+e.toDisplayString(c.question),1)]),e.createElementVNode("div",B,[(e.openBlock(!0),e.createElementBlock(e.Fragment,null,e.renderList(c.choices,(m,h)=>(e.openBlock(),e.createElementBlock("label",{key:h,class:e.normalizeClass([q(a,h),"choice-label"])},[e.withDirectives(e.createElementVNode("input",{type:"radio",name:`question-${a}`,value:h,"onUpdate:modelValue":v=>o.value[a]=v,class:"choice-radio"},null,8,S),[[e.vModelRadio,o.value[a]]]),e.createElementVNode("span",Q,[e.createElementVNode("span",D,e.toDisplayString(String.fromCharCode(65+h))+".",1),e.createTextVNode(" "+e.toDisplayString(m),1)])],2))),128))])]))),128))]),e.createElementVNode("div",$,[e.createElementVNode("button",{onClick:f,disabled:!p.value,class:e.normalizeClass([p.value?"submit-btn-active":"submit-btn-disabled","submit-btn"])}," Submit Answers ",10,C)]),e.createElementVNode("div",A,e.toDisplayString(r.value)+" / "+e.toDisplayString(s.value.questions.length)+" questions answered ",1)])):e.createCommentVNode("",!0)]))}}),g=(l,u)=>{const t=l.__vccOpts||l;for(const[i,s]of u)t[i]=s;return t},y=g(T,[["__scopeId","data-v-f85309ce"]]),x={class:"quiz-preview"},O={key:0,class:"preview-content"},j={class:"preview-title"},M={class:"preview-count"},P={class:"count-badge"},L={class:"preview-question"},F={class:"preview-choices"},R={key:0,class:"more-choices"},U=e.defineComponent({__name:"QuizPreview",props:{result:{}},setup(l){const u=l,t=e.computed(()=>u.result.jsonData);return(i,s)=>(e.openBlock(),e.createElementBlock("div",x,[t.value?(e.openBlock(),e.createElementBlock("div",O,[e.createElementVNode("div",j,e.toDisplayString(t.value.title||"Quiz"),1),e.createElementVNode("div",M,[e.createElementVNode("span",P,e.toDisplayString(t.value.questions.length)+" "+e.toDisplayString(t.value.questions.length===1?"Question":"Questions"),1)]),e.createElementVNode("div",L,e.toDisplayString(t.value.questions[0]?.question),1),e.createElementVNode("div",F,[(e.openBlock(!0),e.createElementBlock(e.Fragment,null,e.renderList(Math.min(t.value.questions[0]?.choices.length||0,4),(o,r)=>(e.openBlock(),e.createElementBlock("div",{key:r,class:"choice-dot"}))),128)),(t.value.questions[0]?.choices.length||0)>4?(e.openBlock(),e.createElementBlock("div",R," +"+e.toDisplayString(t.value.questions[0].choices.length-4),1)):e.createCommentVNode("",!0)])])):e.createCommentVNode("",!0)]))}}),w=g(U,[["__scopeId","data-v-29efb94d"]]),H="putQuestions",I={type:"function",name:H,description:"Present a set of multiple choice questions to test the user's knowledge or abilities. Each question should have 2-6 answer choices.",parameters:{type:"object",properties:{title:{type:"string",description:"Optional title for the quiz (e.g., 'JavaScript Basics Quiz')"},questions:{type:"array",description:"Array of multiple choice questions",items:{type:"object",properties:{question:{type:"string",description:"The question text"},choices:{type:"array",description:"Array of answer choices (2-6 choices)",items:{type:"string"},minItems:2,maxItems:6},correctAnswer:{type:"number",description:"Optional: The index of the correct answer (0-based). Include this if you want to track correct answers."}},required:["question","choices"]},minItems:1}},required:["questions"]}},J=async(l,u)=>{try{const{title:t,questions:i}=u;if(!i||!Array.isArray(i)||i.length===0)throw new Error("At least one question is required");for(let o=0;o<i.length;o++){const r=i[o];if(!r.question||typeof r.question!="string")throw new Error(`Question ${o+1} must have a question text`);if(!Array.isArray(r.choices)||r.choices.length<2)throw new Error(`Question ${o+1} must have at least 2 choices`);if(r.choices.length>6)throw new Error(`Question ${o+1} cannot have more than 6 choices`)}const s={title:t,questions:i};return{message:`Quiz presented with ${i.length} question${i.length>1?"s":""}`,jsonData:s,instructions:"The quiz has been presented to the user. Wait for the user to submit their answers. They will tell you their answers in text format."}}catch(t){return console.error("Quiz creation error",t),{message:`Quiz error: ${t instanceof Error?t.message:"Unknown error"}`,instructions:"Acknowledge that there was an error creating the quiz and suggest trying again."}}},_={toolDefinition:I,execute:J,generatingMessage:"Preparing quiz...",isEnabled:()=>!0,viewComponent:y,previewComponent:w},W={plugin:_};exports.QuizPlugin=W;exports.QuizPreview=w;exports.QuizView=y;exports.default=_;exports.plugin=_;

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * MulmoChat Quiz Plugin
+ *
+ * A plugin for presenting multiple choice quizzes to users.
+ *
+ * @packageDocumentation
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { plugin } from "mulmochat-plugin-quiz";
+ *
+ * // Plugin is ready to use
+ * const tools = [plugin.toolDefinition];
+ * ```
+ *
+ * @example Using Vue components directly
+ * ```typescript
+ * import { QuizView, QuizPreview } from "mulmochat-plugin-quiz";
+ * ```
+ */
+export type { ToolContext, ToolResult, ToolPlugin, ToolDefinition, JsonSchemaProperty, StartApiResponse, FileUploadConfig, ToolPluginConfig, ToolSample, } from "./types";
+export type { QuizQuestion, QuizData, QuizArgs, QuizResult } from "./plugin";
+export { plugin } from "./plugin";
+export { plugin as default } from "./plugin";
+/**
+ * QuizPlugin module matching MulmoChat's expected plugin structure.
+ * Use this for direct import: `import { QuizPlugin } from "mulmochat-plugin-quiz"`
+ */
+export declare const QuizPlugin: {
+    plugin: import("./types").ToolPlugin<never, import("./plugin").QuizData, import("./plugin").QuizArgs>;
+};
+export { default as QuizView } from "./views/QuizView.vue";
+export { default as QuizPreview } from "./previews/QuizPreview.vue";

package/dist/index.js

@@ -0,0 +1,218 @@
+import { defineComponent as k, ref as z, watch as Q, computed as f, createElementBlock as r, openBlock as c, createCommentVNode as m, createElementVNode as i, toDisplayString as a, Fragment as y, renderList as b, createTextVNode as $, normalizeClass as A, withDirectives as D, vModelRadio as E } from "vue";
+const S = { class: "quiz-container" }, N = {
+  key: 0,
+  class: "quiz-content"
+}, O = {
+  key: 0,
+  class: "quiz-title"
+}, j = { class: "questions-list" }, V = { class: "question-text" }, M = { class: "question-number" }, P = { class: "choices-list" }, L = ["name", "value", "onUpdate:modelValue"], R = { class: "choice-text" }, B = { class: "choice-letter" }, F = { class: "submit-section" }, U = ["disabled"], H = { class: "progress-text" }, I = /* @__PURE__ */ k({
+  __name: "QuizView",
+  props: {
+    selectedResult: {},
+    sendTextMessage: { type: Function }
+  },
+  emits: ["updateResult"],
+  setup(d, { emit: p }) {
+    const e = d, n = p, t = z(null), s = z([]);
+    Q(
+      () => e.selectedResult,
+      (o) => {
+        o?.toolName === "putQuestions" && o.jsonData && (t.value = o.jsonData, o.viewState?.userAnswers ? s.value = o.viewState.userAnswers : s.value = new Array(t.value.questions.length).fill(null));
+      },
+      { immediate: !0 }
+    ), Q(
+      s,
+      (o) => {
+        if (e.selectedResult && o) {
+          const v = {
+            ...e.selectedResult,
+            viewState: {
+              userAnswers: o
+            }
+          };
+          n("updateResult", v);
+        }
+      },
+      { deep: !0 }
+    );
+    const u = f(() => s.value.filter((o) => o !== null).length), g = f(() => t.value && u.value === t.value.questions.length);
+    function T(o, v) {
+      return s.value[o] === v ? "choice-selected" : "choice-default";
+    }
+    function x() {
+      if (!t.value || !g.value) return;
+      const v = `Here are my answers:
+${s.value.map((l, h) => {
+        if (l === null) return null;
+        const q = h + 1, _ = String.fromCharCode(65 + l), w = t.value.questions[h].choices[l];
+        return `Q${q}: ${_} - ${w}`;
+      }).filter((l) => l !== null).join(`
+`)}`;
+      e.sendTextMessage(v);
+    }
+    return (o, v) => (c(), r("div", S, [
+      t.value ? (c(), r("div", N, [
+        t.value.title ? (c(), r("h2", O, a(t.value.title), 1)) : m("", !0),
+        i("div", j, [
+          (c(!0), r(y, null, b(t.value.questions, (l, h) => (c(), r("div", {
+            key: h,
+            class: "question-card"
+          }, [
+            i("div", V, [
+              i("span", M, a(h + 1) + ".", 1),
+              $(" " + a(l.question), 1)
+            ]),
+            i("div", P, [
+              (c(!0), r(y, null, b(l.choices, (q, _) => (c(), r("label", {
+                key: _,
+                class: A([T(h, _), "choice-label"])
+              }, [
+                D(i("input", {
+                  type: "radio",
+                  name: `question-${h}`,
+                  value: _,
+                  "onUpdate:modelValue": (w) => s.value[h] = w,
+                  class: "choice-radio"
+                }, null, 8, L), [
+                  [E, s.value[h]]
+                ]),
+                i("span", R, [
+                  i("span", B, a(String.fromCharCode(65 + _)) + ".", 1),
+                  $(" " + a(q), 1)
+                ])
+              ], 2))), 128))
+            ])
+          ]))), 128))
+        ]),
+        i("div", F, [
+          i("button", {
+            onClick: x,
+            disabled: !g.value,
+            class: A([g.value ? "submit-btn-active" : "submit-btn-disabled", "submit-btn"])
+          }, " Submit Answers ", 10, U)
+        ]),
+        i("div", H, a(u.value) + " / " + a(t.value.questions.length) + " questions answered ", 1)
+      ])) : m("", !0)
+    ]));
+  }
+}), C = (d, p) => {
+  const e = d.__vccOpts || d;
+  for (const [n, t] of p)
+    e[n] = t;
+  return e;
+}, J = /* @__PURE__ */ C(I, [["__scopeId", "data-v-f85309ce"]]), W = { class: "quiz-preview" }, G = {
+  key: 0,
+  class: "preview-content"
+}, K = { class: "preview-title" }, X = { class: "preview-count" }, Y = { class: "count-badge" }, Z = { class: "preview-question" }, ee = { class: "preview-choices" }, te = {
+  key: 0,
+  class: "more-choices"
+}, se = /* @__PURE__ */ k({
+  __name: "QuizPreview",
+  props: {
+    result: {}
+  },
+  setup(d) {
+    const p = d, e = f(() => p.result.jsonData);
+    return (n, t) => (c(), r("div", W, [
+      e.value ? (c(), r("div", G, [
+        i("div", K, a(e.value.title || "Quiz"), 1),
+        i("div", X, [
+          i("span", Y, a(e.value.questions.length) + " " + a(e.value.questions.length === 1 ? "Question" : "Questions"), 1)
+        ]),
+        i("div", Z, a(e.value.questions[0]?.question), 1),
+        i("div", ee, [
+          (c(!0), r(y, null, b(Math.min(e.value.questions[0]?.choices.length || 0, 4), (s, u) => (c(), r("div", {
+            key: u,
+            class: "choice-dot"
+          }))), 128)),
+          (e.value.questions[0]?.choices.length || 0) > 4 ? (c(), r("div", te, " +" + a(e.value.questions[0].choices.length - 4), 1)) : m("", !0)
+        ])
+      ])) : m("", !0)
+    ]));
+  }
+}), ie = /* @__PURE__ */ C(se, [["__scopeId", "data-v-29efb94d"]]), oe = "putQuestions", ne = {
+  type: "function",
+  name: oe,
+  description: "Present a set of multiple choice questions to test the user's knowledge or abilities. Each question should have 2-6 answer choices.",
+  parameters: {
+    type: "object",
+    properties: {
+      title: {
+        type: "string",
+        description: "Optional title for the quiz (e.g., 'JavaScript Basics Quiz')"
+      },
+      questions: {
+        type: "array",
+        description: "Array of multiple choice questions",
+        items: {
+          type: "object",
+          properties: {
+            question: {
+              type: "string",
+              description: "The question text"
+            },
+            choices: {
+              type: "array",
+              description: "Array of answer choices (2-6 choices)",
+              items: {
+                type: "string"
+              },
+              minItems: 2,
+              maxItems: 6
+            },
+            correctAnswer: {
+              type: "number",
+              description: "Optional: The index of the correct answer (0-based). Include this if you want to track correct answers."
+            }
+          },
+          required: ["question", "choices"]
+        },
+        minItems: 1
+      }
+    },
+    required: ["questions"]
+  }
+}, re = async (d, p) => {
+  try {
+    const { title: e, questions: n } = p;
+    if (!n || !Array.isArray(n) || n.length === 0)
+      throw new Error("At least one question is required");
+    for (let s = 0; s < n.length; s++) {
+      const u = n[s];
+      if (!u.question || typeof u.question != "string")
+        throw new Error(`Question ${s + 1} must have a question text`);
+      if (!Array.isArray(u.choices) || u.choices.length < 2)
+        throw new Error(`Question ${s + 1} must have at least 2 choices`);
+      if (u.choices.length > 6)
+        throw new Error(`Question ${s + 1} cannot have more than 6 choices`);
+    }
+    const t = {
+      title: e,
+      questions: n
+    };
+    return {
+      message: `Quiz presented with ${n.length} question${n.length > 1 ? "s" : ""}`,
+      jsonData: t,
+      instructions: "The quiz has been presented to the user. Wait for the user to submit their answers. They will tell you their answers in text format."
+    };
+  } catch (e) {
+    return console.error("Quiz creation error", e), {
+      message: `Quiz error: ${e instanceof Error ? e.message : "Unknown error"}`,
+      instructions: "Acknowledge that there was an error creating the quiz and suggest trying again."
+    };
+  }
+}, ce = {
+  toolDefinition: ne,
+  execute: re,
+  generatingMessage: "Preparing quiz...",
+  isEnabled: () => !0,
+  viewComponent: J,
+  previewComponent: ie
+}, ue = { plugin: ce };
+export {
+  ue as QuizPlugin,
+  ie as QuizPreview,
+  J as QuizView,
+  ce as default,
+  ce as plugin
+};

package/dist/plugin.d.ts

@@ -0,0 +1,35 @@
+/**
+ * MulmoChat Quiz Plugin
+ *
+ * A plugin for presenting multiple choice quizzes to users.
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { plugin } from "mulmochat-plugin-quiz";
+ * // Use plugin directly
+ * ```
+ */
+import type { ToolPlugin, ToolResult } from "./types";
+/** Single quiz question */
+export interface QuizQuestion {
+    question: string;
+    choices: string[];
+    correctAnswer?: number;
+}
+/** Quiz data stored in result.jsonData */
+export interface QuizData {
+    title?: string;
+    questions: QuizQuestion[];
+    userAnswers?: number[];
+}
+/** Arguments passed to the quiz tool */
+export interface QuizArgs {
+    title?: string;
+    questions: QuizQuestion[];
+}
+/** Quiz tool result type */
+export type QuizResult = ToolResult<never, QuizData>;
+/**
+ * Quiz plugin instance
+ */
+export declare const plugin: ToolPlugin<never, QuizData, QuizArgs>;

package/dist/previews/QuizPreview.vue.d.ts

@@ -0,0 +1,6 @@
+import type { ToolResult } from "../types";
+type __VLS_Props = {
+    result: ToolResult;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/quiz.css

@@ -0,0 +1 @@
+.quiz-container[data-v-f85309ce]{width:100%;height:100%;overflow-y:auto;padding:2rem;background:#1a1a2e}.quiz-content[data-v-f85309ce]{max-width:48rem;width:100%;margin:0 auto}.quiz-title[data-v-f85309ce]{color:#f0f0f0;font-size:1.875rem;font-weight:700;margin-bottom:2rem;text-align:center}.questions-list[data-v-f85309ce]{display:flex;flex-direction:column;gap:1.5rem}.question-card[data-v-f85309ce]{background:#2d2d44;border-radius:.5rem;padding:1.5rem;border:2px solid #3d3d5c}.question-text[data-v-f85309ce]{color:#fff;font-size:1.125rem;font-weight:600;margin-bottom:1rem}.question-number[data-v-f85309ce]{color:#60a5fa;margin-right:.5rem}.choices-list[data-v-f85309ce]{display:flex;flex-direction:column;gap:.75rem}.choice-label[data-v-f85309ce]{display:flex;align-items:flex-start;padding:1rem;border-radius:.5rem;cursor:pointer;transition:all .2s;border:2px solid transparent}.choice-default[data-v-f85309ce]{border-color:#4b4b6b}.choice-default[data-v-f85309ce]:hover{border-color:#6b6b8b;background:#6b6b8b33}.choice-selected[data-v-f85309ce]{border-color:#3b82f6;background:#3b82f633}.choice-radio[data-v-f85309ce]{margin-top:.25rem;margin-right:.75rem;height:1rem;width:1rem;flex-shrink:0}.choice-text[data-v-f85309ce]{color:#fff;flex:1}.choice-letter[data-v-f85309ce]{font-weight:600;margin-right:.5rem}.submit-section[data-v-f85309ce]{margin-top:2rem;display:flex;justify-content:center}.submit-btn[data-v-f85309ce]{padding:.75rem 2rem;border-radius:.5rem;color:#fff;font-weight:600;font-size:1.125rem;transition:background-color .2s;border:none;cursor:pointer}.submit-btn-active[data-v-f85309ce]{background-color:#2563eb}.submit-btn-active[data-v-f85309ce]:hover{background-color:#1d4ed8}.submit-btn-disabled[data-v-f85309ce]{background-color:#4b5563;cursor:not-allowed;opacity:.5}.progress-text[data-v-f85309ce]{margin-top:1rem;text-align:center;color:#9ca3af;font-size:.875rem}.quiz-preview[data-v-29efb94d]{padding:.75rem;background:#eff6ff;border-radius:.375rem}.preview-content[data-v-29efb94d]{display:flex;flex-direction:column;gap:.5rem}.preview-title[data-v-29efb94d]{font-size:.875rem;font-weight:600;color:#1f2937;text-align:center}.preview-count[data-v-29efb94d]{text-align:center}.count-badge[data-v-29efb94d]{display:inline-block;background:#2563eb;color:#fff;font-size:.75rem;font-weight:700;padding:.25rem .75rem;border-radius:9999px}.preview-question[data-v-29efb94d]{font-size:.75rem;color:#4b5563;overflow:hidden;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical}.preview-choices[data-v-29efb94d]{display:flex;justify-content:center;gap:.25rem}.choice-dot[data-v-29efb94d]{width:.5rem;height:.5rem;background:#9ca3af;border-radius:9999px}.more-choices[data-v-29efb94d]{font-size:.75rem;color:#6b7280}

package/dist/types.d.ts

@@ -0,0 +1,126 @@
+/**
+ * MulmoChat Plugin Types
+ * Core interfaces for building MulmoChat plugins
+ */
+import type { Component } from "vue";
+/**
+ * Context passed to plugin execute function
+ */
+export interface ToolContext {
+    currentResult?: ToolResult<unknown> | null;
+    userPreferences?: Record<string, unknown>;
+    getPluginConfig?: <T = unknown>(key: string) => T | undefined;
+}
+/**
+ * Result returned from plugin execution
+ */
+export interface ToolResult<T = unknown, J = unknown> {
+    toolName?: string;
+    uuid?: string;
+    message: string;
+    title?: string;
+    jsonData?: J;
+    instructions?: string;
+    instructionsRequired?: boolean;
+    updating?: boolean;
+    cancelled?: boolean;
+    data?: T;
+    viewState?: Record<string, unknown>;
+}
+/**
+ * JSON Schema property definition for tool parameters
+ */
+export interface JsonSchemaProperty {
+    type?: string;
+    description?: string;
+    enum?: string[];
+    items?: JsonSchemaProperty;
+    minimum?: number;
+    maximum?: number;
+    minItems?: number;
+    maxItems?: number;
+    properties?: Record<string, JsonSchemaProperty>;
+    required?: string[];
+    additionalProperties?: boolean;
+    oneOf?: JsonSchemaProperty[];
+    [key: string]: unknown;
+}
+/**
+ * API response from server start endpoint
+ */
+export interface StartApiResponse {
+    hasOpenAIApiKey?: boolean;
+    hasAnthropicApiKey?: boolean;
+    hasGoogleApiKey?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Tool definition for OpenAI-compatible function calling
+ */
+export interface ToolDefinition {
+    type: "function";
+    name: string;
+    description: string;
+    parameters?: {
+        type: "object";
+        properties: Record<string, JsonSchemaProperty>;
+        required: string[];
+        additionalProperties?: boolean;
+    };
+}
+/**
+ * File upload configuration
+ */
+export interface FileUploadConfig {
+    acceptedTypes: string[];
+    handleUpload: (fileData: string, fileName: string, ...args: unknown[]) => ToolResult<unknown, unknown>;
+}
+/**
+ * Plugin configuration
+ */
+export interface ToolPluginConfig {
+    key: string;
+    defaultValue: unknown;
+    component: Component;
+}
+/**
+ * Sample arguments for testing
+ */
+export interface ToolSample {
+    name: string;
+    args: Record<string, unknown>;
+}
+/**
+ * Main plugin interface
+ * @template T - Type of data stored in result.data
+ * @template J - Type of data stored in result.jsonData
+ * @template A - Type of arguments passed to execute
+ */
+export interface ToolPlugin<T = unknown, J = unknown, A extends object = object> {
+    /** Tool definition for LLM function calling */
+    toolDefinition: ToolDefinition;
+    /** Execute the plugin with given context and arguments */
+    execute: (context: ToolContext, args: A) => Promise<ToolResult<T, J>>;
+    /** Message shown while generating */
+    generatingMessage: string;
+    /** Message shown while waiting for user action */
+    waitingMessage?: string;
+    /** Message shown during file upload */
+    uploadMessage?: string;
+    /** Check if plugin is enabled based on server capabilities */
+    isEnabled: (startResponse?: StartApiResponse | null) => boolean;
+    /** Delay in ms after execution before proceeding */
+    delayAfterExecution?: number;
+    /** Vue component for full view */
+    viewComponent?: Component;
+    /** Vue component for preview/thumbnail */
+    previewComponent?: Component;
+    /** System prompt additions for this plugin */
+    systemPrompt?: string;
+    /** Optional file upload configuration */
+    fileUpload?: FileUploadConfig;
+    /** Optional plugin-specific configuration */
+    config?: ToolPluginConfig;
+    /** Optional sample arguments for testing */
+    samples?: ToolSample[];
+}

package/dist/views/QuizView.vue.d.ts

@@ -0,0 +1,11 @@
+import type { ToolResult } from "../types";
+type __VLS_Props = {
+    selectedResult: ToolResult;
+    sendTextMessage: (text?: string) => void;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    updateResult: (result: ToolResult<unknown, unknown>) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onUpdateResult?: ((result: ToolResult<unknown, unknown>) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@mulmochat-plugin/quiz",
+  "version": "0.1.0",
+  "description": "Quiz plugin for MulmoChat",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./style.css": "./dist/mulmochat-plugin-quiz.css"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build && vue-tsc --emitDeclarationOnly",
+    "typecheck": "vue-tsc --noEmit",
+    "lint": "eslint src"
+  },
+  "peerDependencies": {
+    "vue": "^3.4.0"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-vue": "^5.0.0",
+    "typescript": "~5.8.0",
+    "vite": "^7.0.0",
+    "vue": "^3.4.0",
+    "vue-tsc": "^2.2.0"
+  },
+  "keywords": [
+    "mulmochat",
+    "plugin",
+    "quiz"
+  ],
+  "license": "MIT"
+}