dsh-openmaic

dsh-openmaic

把 OpenMAIC 带进 DeepSeek Harness。Bring OpenMAIC into DeepSeek Harness.

dsh-openmaic is a DeepSeek Harness plugin that registers four tools and a Socratic teaching skill: openmaic_generate: tell your agent "make me a lesson about X", and the plugin submits the requirement to open.maic.chat, waits for the async generation job, and returns a playable classroom link. openmaic_slide: the agent writes one OpenMAIC slide (PPTist-style Slide JSON) and the plugin renders it with OpenMAIC's official renderer (text, shapes, images, tables, charts, formulas, code). openmaic_widget: the agent writes an OpenMAIC-style interactive widget (simulation, game, or code) per the bundled contract; the code streams as it writes, then renders inline as a sandboxed card. openmaic_render: the agent writes an inline HTML teaching fragment (concept card, quiz, walkthrough) and the plugin renders it as a sandboxed card right in the conversation. openmaic-teach skill: turns a session into a Socratic OpenMAIC lesson, teaching by guided questioning and pulling in slides, widgets, and cards as aids. What it looks like

Interactive widget:

Install

Then restart dsh web and refresh. The plugin ships its compiled lib/, so a git install needs no build step. Config API flow

1. If accessCode is set, POST /api/access-code/verify and replay the openmaic_access cookie on later requests. 2. POST /api/generate-classroom with the requirement, plus only the optional flags you passed. Returns a jobId and pollUrl. 3. Poll GET {pollUrl} until the job is succeeded or failed, or maxWaitMs runs out. 4. On success, return {baseUrl}/classroom/{classroomId} (or the server-provided result.url). Scope openmaic_generate: generate a classroom and return a playable link. openmaic_slide: render one OpenMAIC slide with the official renderer. openmaic_widget: render a simulation / game / code widget the agent writes (a full HTML document). It streams the code while the agent writes it and renders on completion. openmaic_render: render an inline HTML teaching fragment as a sandboxed card. openmaic-teach: Socratic teaching session that uses the tools above as aids.

The slide/widget/render tools do no server-side generation; they render content the agent authors against the OpenMAIC SDK contracts (@openmaic/dsl, @openmaic/generation, @openmaic/renderer). Roadmap Wire the remaining widget types (diagram, visualization3d, procedural-skill). Action loop back to the model (teaching-agent interactions: highlight/annotate/reveal widget elements). Development

The scripts locate the harness checkout from dsh on PATH; set DSH_CHECKOUT to build against a specific checkout. License

MIT