@mulmochat-plugin/quiz 0.2.0 → 0.3.0

package/dist/core/types.d.ts

@@ -1,227 +1,9 @@
 /**
- * MulmoChat Plugin Core Types (Framework-agnostic)
+ * Quiz Plugin Types
  *
- * These types can be used by any framework implementation (Vue, React, etc.)
+ * Quiz-specific type definitions only.
+ * Common types should be imported directly from gui-chat-protocol.
  */
-/**
- * Backend types that plugins can declare they use.
- * App layer manages actual provider/model settings for each type.
- */
-export type BackendType = "textLLM" | "imageGen" | "audio" | "search" | "browse" | "map" | "mulmocast";
-/**
- * App interface provided to plugins via context.app
- * Contains backend functions and config accessors
- */
-export interface ToolContextApp extends Record<string, (...args: any[]) => any> {
-    getConfig: <T = unknown>(key: string) => T | undefined;
-    setConfig: (key: string, value: unknown) => void;
-}
-/**
- * Context passed to plugin execute function
- */
-export interface ToolContext {
-    currentResult?: ToolResult<unknown> | null;
-    app?: ToolContextApp;
-}
-/**
- * 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>;
-}
-/**
- * Complete tool result with required fields
- */
-export interface ToolResultComplete<T = unknown, J = unknown> extends ToolResult<T, J> {
-    toolName: string;
-    uuid: string;
-}
-/**
- * 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;
-}
-/**
- * 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;
-    };
-}
-/**
- * API response from server start endpoint
- */
-export interface StartApiResponse {
-    hasOpenAIApiKey?: boolean;
-    hasAnthropicApiKey?: boolean;
-    hasGoogleApiKey?: boolean;
-    [key: string]: unknown;
-}
-/**
- * Sample arguments for testing
- */
-export interface ToolSample {
-    name: string;
-    args: Record<string, unknown>;
-}
-/**
- * File input handler
- */
-export interface FileInputHandler {
-    type: "file";
-    acceptedTypes: string[];
-    handleInput: (fileData: string, fileName: string) => ToolResult<unknown, unknown>;
-}
-/**
- * Clipboard image input handler
- */
-export interface ClipboardImageInputHandler {
-    type: "clipboard-image";
-    handleInput: (imageData: string) => ToolResult<unknown, unknown>;
-}
-/**
- * URL input handler
- */
-export interface UrlInputHandler {
-    type: "url";
-    patterns?: string[];
-    handleInput: (url: string) => ToolResult<unknown, unknown>;
-}
-/**
- * Text input handler
- */
-export interface TextInputHandler {
-    type: "text";
-    patterns?: string[];
-    handleInput: (text: string) => ToolResult<unknown, unknown>;
-}
-/**
- * Union of all input handler types
- */
-export type InputHandler = FileInputHandler | ClipboardImageInputHandler | UrlInputHandler | TextInputHandler;
-/**
- * Legacy file upload config (for backward compatibility)
- * @deprecated Use InputHandler instead
- */
-export interface FileUploadConfig {
-    acceptedTypes: string[];
-    handleUpload: (fileData: string, fileName: string, ...args: unknown[]) => ToolResult<unknown, unknown>;
-}
-export type ConfigValue = string | number | boolean | string[];
-interface BaseFieldSchema {
-    label: string;
-    description?: string;
-    required?: boolean;
-}
-export interface StringFieldSchema extends BaseFieldSchema {
-    type: "string";
-    placeholder?: string;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-}
-export interface NumberFieldSchema extends BaseFieldSchema {
-    type: "number";
-    min?: number;
-    max?: number;
-    step?: number;
-}
-export interface BooleanFieldSchema extends BaseFieldSchema {
-    type: "boolean";
-}
-export interface SelectOption {
-    value: string;
-    label: string;
-    description?: string;
-    disabled?: boolean;
-}
-export interface SelectFieldSchema extends BaseFieldSchema {
-    type: "select";
-    options: SelectOption[];
-}
-export interface MultiSelectFieldSchema extends BaseFieldSchema {
-    type: "multiselect";
-    options: SelectOption[];
-    minItems?: number;
-    maxItems?: number;
-}
-export type ConfigFieldSchema = StringFieldSchema | NumberFieldSchema | BooleanFieldSchema | SelectFieldSchema | MultiSelectFieldSchema;
-/**
- * Plugin configuration schema (JSON Schema based)
- */
-export interface PluginConfigSchema {
-    key: string;
-    defaultValue: ConfigValue;
-    schema: ConfigFieldSchema;
-}
-/**
- * Standard props for View components
- */
-export interface ViewComponentProps<T = unknown, J = unknown> {
-    selectedResult: ToolResultComplete<T, J>;
-    sendTextMessage: (text?: string) => void;
-    onUpdateResult?: (result: Partial<ToolResult<T, J>>) => void;
-    pluginConfigs?: Record<string, unknown>;
-}
-/**
- * Standard props for Preview components
- */
-export interface PreviewComponentProps<T = unknown, J = unknown> {
-    result: ToolResultComplete<T, J>;
-    isSelected?: boolean;
-    onSelect?: () => void;
-}
-/**
- * Core plugin interface - framework agnostic
- * Does not include UI components
- */
-export interface ToolPluginCore<T = unknown, J = unknown, A extends object = object> {
-    toolDefinition: ToolDefinition;
-    execute: (context: ToolContext, args: A) => Promise<ToolResult<T, J>>;
-    generatingMessage: string;
-    waitingMessage?: string;
-    uploadMessage?: string;
-    isEnabled: (startResponse?: StartApiResponse | null) => boolean;
-    delayAfterExecution?: number;
-    systemPrompt?: string;
-    inputHandlers?: InputHandler[];
-    /** @deprecated Use inputHandlers instead */
-    fileUpload?: FileUploadConfig;
-    /** New JSON Schema based config (framework-agnostic) */
-    configSchema?: PluginConfigSchema;
-    samples?: ToolSample[];
-    backends?: BackendType[];
-}
 /** Single quiz question */
 export interface QuizQuestion {
     question: string;
@@ -239,4 +21,3 @@ export interface QuizArgs {
     title?: string;
     questions: QuizQuestion[];
 }
-export {};

package/dist/react/Preview.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Quiz Preview Component (React)
+ */
+import type { PreviewComponentProps } from "gui-chat-protocol";
+import type { QuizData } from "../core/types";
+type PreviewProps = PreviewComponentProps<never, QuizData>;
+export declare function Preview({ result }: PreviewProps): import("react/jsx-runtime").JSX.Element | null;
+export default Preview;

package/dist/react/View.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Quiz View Component (React)
+ */
+import type { ViewComponentProps } from "gui-chat-protocol";
+import type { QuizData } from "../core/types";
+type ViewProps = ViewComponentProps<never, QuizData>;
+export declare function View({ selectedResult, sendTextMessage, onUpdateResult }: ViewProps): import("react/jsx-runtime").JSX.Element | null;
+export default View;

package/dist/react/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * MulmoChat Quiz Plugin - React Implementation
+ *
+ * Full React plugin with UI components.
+ * Import from "@mulmochat-plugin/quiz/react"
+ */
+import "../style.css";
+import type { ToolPluginReact } from "gui-chat-protocol/react";
+import type { QuizData, QuizArgs } from "../core/types";
+import { View } from "./View";
+import { Preview } from "./Preview";
+/**
+ * Quiz plugin instance with React components
+ */
+export declare const plugin: ToolPluginReact<never, QuizData, QuizArgs>;
+export type { QuizQuestion, QuizData, QuizArgs } from "../core/types";
+export { pluginCore, executeQuiz } from "../core/plugin";
+export { TOOL_NAME, TOOL_DEFINITION } from "../core/definition";
+export { SAMPLES } from "../core/samples";
+export { View, Preview };
+declare const _default: {
+    plugin: ToolPluginReact<never, QuizData, QuizArgs, import("gui-chat-protocol/react").InputHandler, Record<string, unknown>>;
+};
+export default _default;

package/dist/react.cjs

@@ -0,0 +1,8 @@
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});;/* empty css                 */const h=require("./core.cjs"),w=require("react");var S={exports:{}},g={};var W;function ae(){if(W)return g;W=1;var i=Symbol.for("react.transitional.element"),c=Symbol.for("react.fragment");function x(l,d,u){var p=null;if(u!==void 0&&(p=""+u),d.key!==void 0&&(p=""+d.key),"key"in d){u={};for(var v in d)v!=="key"&&(u[v]=d[v])}else u=d;return d=u.ref,{$$typeof:i,type:l,key:p,ref:d!==void 0?d:null,props:u}}return g.Fragment=c,g.jsx=x,g.jsxs=x,g}var T={};var Q;function oe(){return Q||(Q=1,process.env.NODE_ENV!=="production"&&(function(){function i(e){if(e==null)return null;if(typeof e=="function")return e.$$typeof===te?null:e.displayName||e.name||null;if(typeof e=="string")return e;switch(e){case b:return"Fragment";case k:return"Profiler";case y:return"StrictMode";case Z:return"Suspense";case K:return"SuspenseList";case re:return"Activity"}if(typeof e=="object")switch(typeof e.tag=="number"&&console.error("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."),e.$$typeof){case m:return"Portal";case H:return e.displayName||"Context";case P:return(e._context.displayName||"Context")+".Consumer";case B:var r=e.render;return e=e.displayName,e||(e=r.displayName||r.name||"",e=e!==""?"ForwardRef("+e+")":"ForwardRef"),e;case ee:return r=e.displayName||null,r!==null?r:i(e.type)||"Memo";case C:r=e._payload,e=e._init;try{return i(e(r))}catch{}}return null}function c(e){return""+e}function x(e){try{c(e);var r=!1}catch{r=!0}if(r){r=console;var n=r.error,a=typeof Symbol=="function"&&Symbol.toStringTag&&e[Symbol.toStringTag]||e.constructor.name||"Object";return n.call(r,"The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",a),c(e)}}function l(e){if(e===b)return"<>";if(typeof e=="object"&&e!==null&&e.$$typeof===C)return"<...>";try{var r=i(e);return r?"<"+r+">":"<...>"}catch{return"<...>"}}function d(){var e=$.A;return e===null?null:e.getOwner()}function u(){return Error("react-stack-top-frame")}function p(e){if(L.call(e,"key")){var r=Object.getOwnPropertyDescriptor(e,"key").get;if(r&&r.isReactWarning)return!1}return e.key!==void 0}function v(e,r){function n(){M||(M=!0,console.error("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",r))}n.isReactWarning=!0,Object.defineProperty(e,"key",{get:n,configurable:!0})}function O(){var e=i(this.type);return F[e]||(F[e]=!0,console.error("Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release.")),e=this.props.ref,e!==void 0?e:null}function j(e,r,n,a,A,D){var o=n.ref;return e={$$typeof:f,type:e,key:r,props:n,_owner:a},(o!==void 0?o:null)!==null?Object.defineProperty(e,"ref",{enumerable:!1,get:O}):Object.defineProperty(e,"ref",{enumerable:!1,value:null}),e._store={},Object.defineProperty(e._store,"validated",{configurable:!1,enumerable:!1,writable:!0,value:0}),Object.defineProperty(e,"_debugInfo",{configurable:!1,enumerable:!1,writable:!0,value:null}),Object.defineProperty(e,"_debugStack",{configurable:!1,enumerable:!1,writable:!0,value:A}),Object.defineProperty(e,"_debugTask",{configurable:!1,enumerable:!1,writable:!0,value:D}),Object.freeze&&(Object.freeze(e.props),Object.freeze(e)),e}function _(e,r,n,a,A,D){var o=r.children;if(o!==void 0)if(a)if(ne(o)){for(a=0;a<o.length;a++)N(o[a]);Object.freeze&&Object.freeze(o)}else console.error("React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.");else N(o);if(L.call(r,"key")){o=i(e);var E=Object.keys(r).filter(function(se){return se!=="key"});a=0<E.length?"{key: someKey, "+E.join(": ..., ")+": ...}":"{key: someKey}",V[o+a]||(E=0<E.length?"{"+E.join(": ..., ")+": ...}":"{}",console.error(`A props object containing a "key" prop is being spread into JSX:
+  let props = %s;
+  <%s {...props} />
+React keys must be passed directly to JSX without using spread:
+  let props = %s;
+  <%s key={someKey} {...props} />`,a,o,E,o),V[o+a]=!0)}if(o=null,n!==void 0&&(x(n),o=""+n),p(r)&&(x(r.key),o=""+r.key),"key"in r){n={};for(var Y in r)Y!=="key"&&(n[Y]=r[Y])}else n=r;return o&&v(n,typeof e=="function"?e.displayName||e.name||"Unknown":e),j(e,o,n,d(),A,D)}function N(e){R(e)?e._store&&(e._store.validated=1):typeof e=="object"&&e!==null&&e.$$typeof===C&&(e._payload.status==="fulfilled"?R(e._payload.value)&&e._payload.value._store&&(e._payload.value._store.validated=1):e._store&&(e._store.validated=1))}function R(e){return typeof e=="object"&&e!==null&&e.$$typeof===f}var s=w,f=Symbol.for("react.transitional.element"),m=Symbol.for("react.portal"),b=Symbol.for("react.fragment"),y=Symbol.for("react.strict_mode"),k=Symbol.for("react.profiler"),P=Symbol.for("react.consumer"),H=Symbol.for("react.context"),B=Symbol.for("react.forward_ref"),Z=Symbol.for("react.suspense"),K=Symbol.for("react.suspense_list"),ee=Symbol.for("react.memo"),C=Symbol.for("react.lazy"),re=Symbol.for("react.activity"),te=Symbol.for("react.client.reference"),$=s.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,L=Object.prototype.hasOwnProperty,ne=Array.isArray,q=console.createTask?console.createTask:function(){return null};s={react_stack_bottom_frame:function(e){return e()}};var M,F={},z=s.react_stack_bottom_frame.bind(s,u)(),I=q(l(u)),V={};T.Fragment=b,T.jsx=function(e,r,n){var a=1e4>$.recentlyCreatedOwnerStacks++;return _(e,r,n,!1,a?Error("react-stack-top-frame"):z,a?q(l(e)):I)},T.jsxs=function(e,r,n){var a=1e4>$.recentlyCreatedOwnerStacks++;return _(e,r,n,!0,a?Error("react-stack-top-frame"):z,a?q(l(e)):I)}})()),T}var U;function le(){return U||(U=1,process.env.NODE_ENV==="production"?S.exports=ae():S.exports=oe()),S.exports}var t=le();function J({selectedResult:i,sendTextMessage:c,onUpdateResult:x}){const[l,d]=w.useState(null),[u,p]=w.useState([]);w.useEffect(()=>{if(i?.toolName===h.TOOL_NAME&&i.jsonData){const s=i.jsonData;d(s),i.viewState?.userAnswers?p(i.viewState.userAnswers):p(new Array(s.questions.length).fill(null))}},[i]);const v=w.useCallback(s=>{p(s),x&&x({viewState:{userAnswers:s}})},[x]),O=(s,f)=>{const m=[...u];m[s]=f,v(m)},j=u.filter(s=>s!==null).length,_=l&&j===l.questions.length,N=(s,f)=>u[s]===f?"border-blue-500 bg-blue-500/20":"border-[#4b4b6b] hover:border-[#6b6b8b] hover:bg-[#6b6b8b]/20",R=()=>{if(!l||!_)return;const f=`Here are my answers:
+${u.map((m,b)=>{if(m===null)return null;const y=b+1,k=String.fromCharCode(65+m),P=l.questions[b].choices[m];return`Q${y}: ${k} - ${P}`}).filter(m=>m!==null).join(`
+`)}`;c(f)};return l?t.jsx("div",{className:"w-full min-h-[400px] overflow-y-auto p-8 bg-[#1a1a2e] rounded-lg",children:t.jsxs("div",{className:"max-w-3xl mx-auto",children:[l.title&&t.jsx("h2",{className:"text-[#f0f0f0] text-3xl font-bold mb-8 text-center",children:l.title}),t.jsx("div",{className:"flex flex-col gap-6",children:l.questions.map((s,f)=>t.jsxs("div",{className:"bg-[#2d2d44] rounded-lg p-6 border-2 border-[#3d3d5c]",children:[t.jsxs("div",{className:"text-white text-lg font-semibold mb-4",children:[t.jsxs("span",{className:"text-blue-400 mr-2",children:[f+1,"."]}),s.question]}),t.jsx("div",{className:"flex flex-col gap-3",children:s.choices.map((m,b)=>t.jsxs("label",{className:`flex items-start p-4 rounded-lg cursor-pointer transition-all duration-200 border-2 ${N(f,b)}`,children:[t.jsx("input",{type:"radio",name:`question-${f}`,value:b,checked:u[f]===b,onChange:()=>O(f,b),className:"mt-1 mr-3 size-4 shrink-0"}),t.jsxs("span",{className:"text-white flex-1",children:[t.jsxs("span",{className:"font-semibold mr-2",children:[String.fromCharCode(65+b),"."]}),m]})]},b))})]},f))}),t.jsx("div",{className:"mt-8 flex justify-center",children:t.jsx("button",{onClick:R,disabled:!_,className:`py-3 px-8 rounded-lg text-white font-semibold text-lg transition-colors border-none cursor-pointer ${_?"bg-blue-600 hover:bg-blue-700":"bg-gray-600 cursor-not-allowed opacity-50"}`,children:"Submit Answers"})}),t.jsxs("div",{className:"mt-4 text-center text-gray-400 text-sm",children:[j," / ",l.questions.length," questions answered"]})]})}):null}function G({result:i}){const c=i.jsonData;return c?t.jsx("div",{className:"p-3 bg-blue-50 rounded-md",children:t.jsxs("div",{className:"flex flex-col gap-2",children:[t.jsx("div",{className:"text-sm font-semibold text-gray-800 text-center",children:c.title||"Quiz"}),t.jsx("div",{className:"text-center",children:t.jsxs("span",{className:"inline-block bg-blue-600 text-white text-xs font-bold py-1 px-3 rounded-full",children:[c.questions.length," ",c.questions.length===1?"Question":"Questions"]})}),t.jsx("div",{className:"text-xs text-gray-600 overflow-hidden line-clamp-2",children:c.questions[0]?.question}),t.jsxs("div",{className:"flex justify-center gap-1",children:[Array.from({length:Math.min(c.questions[0]?.choices.length||0,4)}).map((x,l)=>t.jsx("div",{className:"size-2 bg-gray-400 rounded-full"},l)),(c.questions[0]?.choices.length||0)>4&&t.jsxs("span",{className:"text-xs text-gray-500",children:["+",c.questions[0].choices.length-4]})]})]})}):null}const X={...h.pluginCore,ViewComponent:J,PreviewComponent:G},ie={plugin:X};exports.SAMPLES=h.SAMPLES;exports.TOOL_DEFINITION=h.TOOL_DEFINITION;exports.TOOL_NAME=h.TOOL_NAME;exports.executeQuiz=h.executeQuiz;exports.pluginCore=h.pluginCore;exports.Preview=G;exports.View=J;exports.default=ie;exports.plugin=X;