@codio-ai/opencode-authoring-agent 0.1.4 → 0.1.6

package/dist/agents/assessment-author.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assessment-author.d.ts","sourceRoot":"","sources":["../../src/agents/assessment-author.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAiC/C,wBAAgB,2BAA2B,CACzC,KAAK,CAAC,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,EACrB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,eAAe,CAkBjB"}
+{"version":3,"file":"assessment-author.d.ts","sourceRoot":"","sources":["../../src/agents/assessment-author.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AA2C/C,wBAAgB,2BAA2B,CACzC,KAAK,CAAC,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,EACrB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,eAAe,CAkBjB"}

package/dist/agents/orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/agents/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAmD/C,wBAAgB,uBAAuB,CAAC,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAmG5E;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,CAAC,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,EACrB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAC3B,eAAe,CAiBjB"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/agents/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAmD/C,wBAAgB,uBAAuB,CAAC,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAoG5E;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,CAAC,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,EACrB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAC3B,eAAe,CAiBjB"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAUlD,QAAA,MAAM,oBAAoB,EA0FT,MAAM,CAAC;AAExB,eAAe,oBAAoB,CAAC;AAEpC,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAUlD,QAAA,MAAM,oBAAoB,EA4FT,MAAM,CAAC;AAExB,eAAe,oBAAoB,CAAC;AAEpC,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -3945,7 +3945,7 @@ var require_lodash = __commonJS((exports, module) => {
         }
         return mapped.length && mapped[0] === arrays[0] ? baseIntersection(mapped, undefined2, comparator) : [];
       });
-      function join5(array, separator) {
+      function join6(array, separator) {
         return array == null ? "" : nativeJoin.call(array, separator);
       }
       function last(array) {
@@ -5882,7 +5882,7 @@ __p += '`;
       lodash.isUndefined = isUndefined;
       lodash.isWeakMap = isWeakMap;
       lodash.isWeakSet = isWeakSet;
-      lodash.join = join5;
+      lodash.join = join6;
       lodash.kebabCase = kebabCase;
       lodash.last = last;
       lodash.lastIndexOf = lastIndexOf;
@@ -16380,11 +16380,11 @@ var require_path_arg = __commonJS((exports, module) => {
 
 // node_modules/tar/node_modules/mkdirp/lib/find-made.js
 var require_find_made = __commonJS((exports, module) => {
-  var { dirname: dirname2 } = __require("path");
+  var { dirname: dirname3 } = __require("path");
   var findMade = (opts, parent, path = undefined) => {
     if (path === parent)
       return Promise.resolve();
-    return opts.statAsync(parent).then((st) => st.isDirectory() ? path : undefined, (er) => er.code === "ENOENT" ? findMade(opts, dirname2(parent), parent) : undefined);
+    return opts.statAsync(parent).then((st) => st.isDirectory() ? path : undefined, (er) => er.code === "ENOENT" ? findMade(opts, dirname3(parent), parent) : undefined);
   };
   var findMadeSync = (opts, parent, path = undefined) => {
     if (path === parent)
@@ -16392,7 +16392,7 @@ var require_find_made = __commonJS((exports, module) => {
     try {
       return opts.statSync(parent).isDirectory() ? path : undefined;
     } catch (er) {
-      return er.code === "ENOENT" ? findMadeSync(opts, dirname2(parent), parent) : undefined;
+      return er.code === "ENOENT" ? findMadeSync(opts, dirname3(parent), parent) : undefined;
     }
   };
   module.exports = { findMade, findMadeSync };
@@ -16400,10 +16400,10 @@ var require_find_made = __commonJS((exports, module) => {
 
 // node_modules/tar/node_modules/mkdirp/lib/mkdirp-manual.js
 var require_mkdirp_manual = __commonJS((exports, module) => {
-  var { dirname: dirname2 } = __require("path");
+  var { dirname: dirname3 } = __require("path");
   var mkdirpManual = (path, opts, made) => {
     opts.recursive = false;
-    const parent = dirname2(path);
+    const parent = dirname3(path);
     if (parent === path) {
       return opts.mkdirAsync(path, opts).catch((er) => {
         if (er.code !== "EISDIR")
@@ -16426,7 +16426,7 @@ var require_mkdirp_manual = __commonJS((exports, module) => {
     });
   };
   var mkdirpManualSync = (path, opts, made) => {
-    const parent = dirname2(path);
+    const parent = dirname3(path);
     opts.recursive = false;
     if (parent === path) {
       try {
@@ -16459,12 +16459,12 @@ var require_mkdirp_manual = __commonJS((exports, module) => {
 
 // node_modules/tar/node_modules/mkdirp/lib/mkdirp-native.js
 var require_mkdirp_native = __commonJS((exports, module) => {
-  var { dirname: dirname2 } = __require("path");
+  var { dirname: dirname3 } = __require("path");
   var { findMade, findMadeSync } = require_find_made();
   var { mkdirpManual, mkdirpManualSync } = require_mkdirp_manual();
   var mkdirpNative = (path, opts) => {
     opts.recursive = true;
-    const parent = dirname2(path);
+    const parent = dirname3(path);
     if (parent === path)
       return opts.mkdirAsync(path, opts);
     return findMade(opts, path).then((made) => opts.mkdirAsync(path, opts).then(() => made).catch((er) => {
@@ -16476,7 +16476,7 @@ var require_mkdirp_native = __commonJS((exports, module) => {
   };
   var mkdirpNativeSync = (path, opts) => {
     opts.recursive = true;
-    const parent = dirname2(path);
+    const parent = dirname3(path);
     if (parent === path)
       return opts.mkdirSync(path, opts);
     const made = findMadeSync(opts, path);
@@ -16865,7 +16865,7 @@ var require_path_reservations = __commonJS((exports, module) => {
   var assert = __require("assert");
   var normalize = require_normalize_unicode();
   var stripSlashes = require_strip_trailing_slashes();
-  var { join: join5 } = __require("path");
+  var { join: join6 } = __require("path");
   var platform = process.env.TESTING_TAR_FAKE_PLATFORM || process.platform;
   var isWindows = platform === "win32";
   module.exports = () => {
@@ -16874,7 +16874,7 @@ var require_path_reservations = __commonJS((exports, module) => {
     const getDirs = (path) => {
       const dirs = path.split("/").slice(0, -1).reduce((set, path2) => {
         if (set.length) {
-          path2 = join5(set[set.length - 1], path2);
+          path2 = join6(set[set.length - 1], path2);
         }
         set.push(path2 || "/");
         return set;
@@ -16942,7 +16942,7 @@ var require_path_reservations = __commonJS((exports, module) => {
     };
     const reserve = (paths, fn) => {
       paths = isWindows ? ["win32 parallelization disabled"] : paths.map((p) => {
-        return stripSlashes(join5(normalize(p))).toLowerCase();
+        return stripSlashes(join6(normalize(p))).toLowerCase();
       });
       const dirs = new Set(paths.map((path) => getDirs(path)).reduce((a, b) => a.concat(b)));
       reservations.set(fn, { dirs, paths });
@@ -18231,7 +18231,7 @@ var require_BufferList = __commonJS((exports, module) => {
       this.head = this.tail = null;
       this.length = 0;
     };
-    BufferList.prototype.join = function join5(s) {
+    BufferList.prototype.join = function join6(s) {
       if (this.length === 0)
         return "";
       var p = this.head;
@@ -20411,7 +20411,7 @@ var require_BufferList2 = __commonJS((exports, module) => {
       this.head = this.tail = null;
       this.length = 0;
     };
-    BufferList.prototype.join = function join5(s) {
+    BufferList.prototype.join = function join6(s) {
       if (this.length === 0)
         return "";
       var p = this.head;
@@ -22536,7 +22536,7 @@ var require_buffer_list = __commonJS((exports, module) => {
       }
     }, {
       key: "join",
-      value: function join5(s) {
+      value: function join6(s) {
         if (this.length === 0)
           return "";
         var p = this.head;
@@ -45788,13 +45788,13 @@ ${customAppendPrompt}`;
 // src/agents/assessment-author.ts
 var BASE_PROMPT = `# Assessment Author
 
-You author one or more assessments (MCQ, code test, fill-in-the-blanks, parsons-puzzle, or llm-based-auto-rubric) for a Codio guide page. You return structured payloads. **You do not write JSON or files directly.** The orchestrator passes your payload to the \`create_assessment\` tool, which stamps the canonical JSON and writes it.
+You author one or more assessments (MCQ, code test, fill-in-the-blanks, parsons-puzzle, llm-based-auto-rubric, or probeable-question-act) for a Codio guide page. You return structured payloads. **You do not write JSON or files directly.** The orchestrator passes your payload to the \`create_assessment\` tool, which stamps the canonical JSON and writes it.
 
 ## Inputs
 
-- \`assessment_type\`: one of \`multiple-choice\`, \`code-output-compare\`, \`fill-in-the-blanks\`, \`parsons-puzzle\`, \`llm-based-auto-rubric\`.
+- \`assessment_type\`: one of \`multiple-choice\`, \`code-output-compare\`, \`fill-in-the-blanks\`, \`parsons-puzzle\`, \`llm-based-auto-rubric\`, \`probeable-question-act\`.
 - \`topic\`, \`lo\` (learning objective), \`page_context\` (the page body for grounding).
-- \`count\` (how many to author; default 1 for code-test/FITB/parsons/auto-rubric, 3 for MCQ).
+- \`count\` (how many to author; default 1 for code-test/FITB/parsons/auto-rubric/probeable, 3 for MCQ).
 
 ## Output
 
@@ -45807,6 +45807,16 @@ Return one payload per assessment, in the exact shape \`create_assessment\` expe
 - For \`fill-in-the-blanks\`: use the \`<<<answer>>>\` marker syntax inline in the \`text\` field. Each blank should test one concrete piece of recall or application.
 - For \`parsons-puzzle\`: provide a correct code solution as \`initial\`, then append distractor lines below — each distractor labeled with a \`#distractor\` comment so the orchestrator can review. Aim for 2–4 distractors that reflect common syntactic or logical mistakes (off-by-one, wrong operator, wrong variable name). Indent matters for Python — call out which indent levels each block needs.
 - For \`llm-based-auto-rubric\`: write 3–5 rubric items, each scoped to one observable dimension (syntax, logic, edge cases, style). Each item has a clear \`title\` and a \`description\` written for the LLM grader to apply (concrete criteria, not vague). Always include a \`solutions\` array under \`.guides/secure/\` so the grader has reference; never expose solution paths under \`.guides/content/\`.
+- For \`probeable-question-act\`: collect these fields before returning the payload:
+  - \`functionName\` — Python function name (snake_case), used as the file stem.
+  - \`functionSignature\` — full def line with type hints, e.g. \`def min_index(int_list: list[int]) -> int:\`
+  - \`problemStatement\` — narrative description of what the function must do.
+  - \`inputVariable\` — the variable students modify to probe, e.g. \`int_list\`.
+  - \`inputVariableAnnotation\` — Python type annotation, e.g. \`list[int]\`.
+  - \`defaultInputValue\` — default value shown in the student file, e.g. \`[1, 2, 3]\`.
+  - \`referenceSolution\` — the complete working function definition (including the \`def\` line and body).
+  - \`unitTests\` — full Python unittest file content.
+  **If the instructor has not provided \`referenceSolution\` or \`unitTests\`, ask whether they want to supply them or have you generate them. Generate only if the instructor explicitly says to.**
 
 ## What you don't do
 
@@ -45819,7 +45829,7 @@ function createAssessmentAuthorAgent(model, customPrompt, customAppendPrompt) {
   const prompt = resolvePrompt(BASE_PROMPT, customPrompt, customAppendPrompt);
   return {
     name: "assessment-author",
-    description: "Authors MCQ / code-output-compare / fill-in-the-blanks / parsons-puzzle / llm-based-auto-rubric payloads. Returns structured payloads; does not write files.",
+    description: "Authors MCQ / code-output-compare / fill-in-the-blanks / parsons-puzzle / llm-based-auto-rubric / probeable-question-act payloads. Returns structured payloads; does not write files.",
     config: {
       mode: "subagent",
       model,
@@ -45854,11 +45864,11 @@ var AGENT_DESCRIPTIONS = {
 - **Rule of thumb:** New prose or non-trivial edit → @page-author. Trivial fix → yourself.
 - **layoutConfig:** When delegating, include \`layoutConfig: { openFiles: string[] }\` derived from the page's \`files\` list so @page-author can generate adaptive file instructions.`,
   "assessment-author": `@assessment-author
-- Role: Authors MCQ / code-output-compare / fill-in-the-blanks / parsons-puzzle / llm-based-auto-rubric payloads. Returns structured payloads only.
+- Role: Authors MCQ / code-output-compare / fill-in-the-blanks / parsons-puzzle / llm-based-auto-rubric / probeable-question-act payloads. Returns structured payloads only.
 - Permissions: Read only
 - Stats: Pedagogy + distractor quality is the hardest content judgment in this system. Sonnet-class.
-- Capabilities: MCQ pedagogy, code-test design, FITB construction, Parsons distractor design, LLM rubric authoring.
-- **Delegate when:** Authoring any new assessment (multiple-choice, code-output-compare, fill-in-the-blanks, parsons-puzzle, llm-based-auto-rubric).
+- Capabilities: MCQ pedagogy, code-test design, FITB construction, Parsons distractor design, LLM rubric authoring, probeable question design.
+- **Delegate when:** Authoring any new assessment (multiple-choice, code-output-compare, fill-in-the-blanks, parsons-puzzle, llm-based-auto-rubric, probeable-question-act).
 - **Don't delegate when:** Re-running create_assessment with the same payload (no LLM work needed).
 - **Rule of thumb:** New question content → @assessment-author. Re-stamp existing payload → tool only.`,
   "source-ingester": `@source-ingester
@@ -45909,12 +45919,12 @@ ${enabledAgents}
 
 ### Authoring tools
 - \`create_page({workspace, stem, title, type, layout, learningObjectives, files?, markdownBody, chapterFolder?})\` — stamp a page JSON with a fresh v4 UUID and write the JSON+MD pair. Use after \`@page-author\` returns a body+metadata in draft mode. Validates freeze directive syntax before writing — will throw if FREEZE CODE BEGIN/END are unmatched or use wrong comment prefix for the language.
-- \`create_assessment({type, workspace, payload})\` — stamp an assessment JSON with a fresh taskId and write to \`.guides/assessments/\`. Returns \`{ taskId, jsonPath, embedLine }\`. Use after \`@assessment-author\` returns a payload. The returned \`embedLine\` is what you splice into the page markdown.
+- \`create_assessment({type, workspace, payload})\` — stamp an assessment JSON with a fresh taskId and write to \`.guides/assessments/\`. Returns \`{ taskId, jsonPath, embedLine }\` for standard types. For \`probeable-question-act\` also returns \`{ studentFilePath, probeScriptPath, probeButtonCommand, runButtonCommand, suggestedPageMarkdown }\` and writes 3 additional files (student file, probe script, unit test file). Use \`suggestedPageMarkdown\` as the body_brief for \`@page-author\` when creating the guide page for a probeable question.
 - \`validate_guide({workspace})\` — deterministic structural validation (UUIDs, order arrays, embed references, taskId/filename consistency). Run automatically at the end of new-assignment, import-source, and reorder workflows. Run manually on user request (\`/validate-guide\`).
 
 ### Codio platform tools
-- \`fetch_course({workspace, courseId, outputDir?, domain?})\` — pull an existing Codio course from the platform into an AI-ready local project. Requires \`CODIO_CLIENT_ID\` and \`CODIO_CLIENT_SECRET\` env vars. Returns \`{ outputDir, manifestPath, moduleCount, assignmentCount }\`. Writes \`course-manifest.json\`, \`course-assignments.csv\`, and extracted assignment content under \`course-content/\`. **Delegate when:** user wants to fetch, pull, import, or export an existing Codio course.
-- \`publish_course({manifestPath, dryRun?, force?, module?, assignment?, changelog?, stack?})\` — push course assignments back to the Codio platform using \`course-manifest.json\` as the source of truth. Creates missing courses/modules/assignments automatically. Skips unchanged assignments by content hash. Returns \`{ published, created, unchanged, skipped }\`. **Delegate when:** user wants to publish, push, deploy, or sync assignments to Codio. Always suggest \`dryRun: true\` first to preview.
+- \`fetch_course({courseId, workspace?, outputDir?, domain?})\` — pull an existing Codio course from the platform into an AI-ready local project. Requires \`CODIO_CLIENT_ID\` and \`CODIO_CLIENT_SECRET\` env vars. Returns \`{ outputDir, manifestPath, moduleCount, assignmentCount }\`. Writes \`course-manifest.json\`, \`course-assignments.csv\`, and extracted assignment content under \`course-content/\`. **Delegate when:** user wants to fetch, pull, import, or export an existing Codio course.
+- \`publish_course({manifestPath, workspace?, dryRun?, force?, module?, assignment?, changelog?, stack?})\` — push course assignments back to the Codio platform using \`course-manifest.json\` as the source of truth. Creates missing courses/modules/assignments automatically. Skips unchanged assignments by content hash. Returns \`{ published, created, unchanged, skipped }\`. **Delegate when:** user wants to publish, push, deploy, or sync assignments to Codio. Always suggest \`dryRun: true\` first to preview.
 
 ### Platform tool routing
 - User says "fetch/pull/import/export this course" → \`fetch_course\`
@@ -45942,7 +45952,8 @@ Only fan out where work is independent — page drafting (Phase 4) and assessmen
 
 - New page JSON+MD pair → \`@page-author\` (draft mode) returns body+metadata → you call \`create_page\`. **Do not** hand-write the JSON.
 - Existing page surgical edit → \`@page-author\` (revise mode) edits the .md directly. No tool call.
-- New assessment → \`@assessment-author\` returns payload → you call \`create_assessment\` → you splice the returned \`embedLine\` into the page.
+- New standard assessment → \`@assessment-author\` returns payload → you call \`create_assessment\` → you splice the returned \`embedLine\` into the page.
+- New probeable question → \`@assessment-author\` returns payload → you call \`create_assessment\` (type: probeable-question-act) → use \`suggestedPageMarkdown\` as body_brief for \`@page-author\` → call \`create_page\`.
 - \`order\` array updates → you edit the index.json yourself with the edit tool. Small contextual JSON; no tool needed.
 - Stem generation (kebab-slug + 4-hex) → you generate inline. No tool.
 </Workflow>
@@ -46455,14 +46466,20 @@ var ASSESSMENT_TYPES = [
   "code-output-compare",
   "fill-in-the-blanks",
   "parsons-puzzle",
-  "llm-based-auto-rubric"
+  "llm-based-auto-rubric",
+  "probeable-question-act"
 ];
-var TASKID_RE = new RegExp(`^(${ASSESSMENT_TYPES.join("|")})-[1-9][0-9]{9}$`);
-var ANY_TASKID_RE = new RegExp(`(?:${ASSESSMENT_TYPES.join("|")})-[1-9][0-9]{9}`, "g");
+var TASKID_PREFIX = {
+  "probeable-question-act": "test"
+};
+var ALL_PREFIXES = [...new Set(ASSESSMENT_TYPES.map((t) => TASKID_PREFIX[t] ?? t))];
+var TASKID_RE = new RegExp(`^(${ALL_PREFIXES.join("|")})-[1-9][0-9]{9}$`);
+var ANY_TASKID_RE = new RegExp(`(?:${ALL_PREFIXES.join("|")})-[1-9][0-9]{9}`, "g");
 function generateTaskId(type) {
+  const prefix = TASKID_PREFIX[type] ?? type;
   const first = randomInt(1, 10);
   const rest = randomInt(0, 1e9).toString().padStart(9, "0");
-  return `${type}-${first}${rest}`;
+  return `${prefix}-${first}${rest}`;
 }
 
 // src/utils/uuid.ts
@@ -46481,7 +46498,8 @@ var ASSESSMENT_TYPE_TAG = {
   "code-output-compare": "Standard Code Test",
   "fill-in-the-blanks": "Fill in the Blanks",
   "parsons-puzzle": "Parsons Puzzle",
-  "llm-based-auto-rubric": null
+  "llm-based-auto-rubric": null,
+  "probeable-question-act": "Advanced Code Test"
 };
 function ensureAssessmentTag(tags, type) {
   const list = tags ? [...tags] : [];
@@ -46808,6 +46826,170 @@ function buildLlmAutoRubricAssessment(raw, taskId = generateTaskId("llm-based-au
     }
   };
 }
+var probeablePayloadSchema = z2.object({
+  functionName: z2.string().min(1),
+  functionSignature: z2.string().min(1),
+  problemStatement: z2.string().min(1),
+  inputVariable: z2.string().min(1),
+  inputVariableAnnotation: z2.string().min(1),
+  defaultInputValue: z2.string().min(1),
+  referenceSolution: z2.string().min(1),
+  unitTests: z2.string().min(1),
+  name: z2.string().optional(),
+  points: z2.number().int().nonnegative().default(20),
+  maxAttemptsCount: z2.number().int().nonnegative().default(0),
+  timeoutSeconds: z2.number().int().positive().default(40),
+  guidance: z2.string().default(""),
+  lo: z2.string().default(""),
+  blooms: z2.string().default("")
+});
+function indentLines(text, spaces) {
+  const pad = " ".repeat(spaces);
+  return text.split(`
+`).map((line) => line.trim() ? pad + line : line).join(`
+`);
+}
+function buildProbeableAssessment(raw, taskId, workspace) {
+  const p = probeablePayloadSchema.parse(raw);
+  const fn = p.functionName;
+  const studentFilePath = `code/functions/probeable_${fn}.py`;
+  const probeScriptPath = `.guides/probeable_questions/probe_${fn}.py`;
+  const unitTestPath = `.guides/secure/unit_tests/probeable_questions/${fn}_test.py`;
+  const studentFileContent = [
+    `# Probe ${fn}: Modify only the ${p.inputVariable} values to test edge cases`,
+    ``,
+    `${p.inputVariable}: ${p.inputVariableAnnotation} = ${p.defaultInputValue}`,
+    ``,
+    `${p.functionSignature}`,
+    `  # Replace 'pass' with your solution`,
+    `  pass`,
+    ``,
+    ``,
+    ``,
+    `# FREEZE CODE BEGIN`,
+    `if __name__=="__main__":`,
+    `  print(f"${p.inputVariable} = {${p.inputVariable}} , result = {${fn}(${p.inputVariable})}")`,
+    `# FREEZE CODE END`
+  ].join(`
+`);
+  const indentedSolution = indentLines(p.referenceSolution.trimEnd(), 4);
+  const moduleName = `probeable_${fn}`;
+  const logFile = `${workspace}/code/functions/probeable_${fn}_io_logs.txt`;
+  const probeScriptContent = [
+    `import sys`,
+    `sys.path.append("${workspace}/code/functions/")`,
+    ``,
+    `class MissingVariableError(Exception):`,
+    `  def __str__(self):`,
+    `    return "Error: The required '${p.inputVariable}' variable is missing. Please declare '${p.inputVariable}' as a ${p.inputVariableAnnotation}."`,
+    ``,
+    ``,
+    `def check_import_and_probe():`,
+    `  try:`,
+    `    from ${moduleName} import ${p.inputVariable}`,
+    ``,
+    `${indentedSolution}`,
+    ``,
+    `    if __name__ == "__main__":`,
+    `      log_file = "${logFile}"`,
+    `      result = ${fn}(${p.inputVariable})`,
+    `      with open(log_file, "a") as f:`,
+    `        f.write(f"${p.inputVariable} = {${p.inputVariable}} , result = {result}\\n")`,
+    `      with open(log_file, "r") as f:`,
+    `        for line in f.readlines():`,
+    `          print(line)`,
+    ``,
+    `  except ImportError:`,
+    `    raise MissingVariableError()`,
+    `try:`,
+    `  check_import_and_probe()`,
+    `except MissingVariableError as e:`,
+    `  print(e)`,
+    `  sys.exit(1)`
+  ].join(`
+`);
+  const codeEnvConfig = JSON.stringify({
+    type: "python",
+    subtype: "unittest",
+    files: [unitTestPath],
+    maxPoints: p.points,
+    timeout: p.timeoutSeconds,
+    executable: "python3",
+    pythonwd: ".guides/secure/unit_tests/probeable_questions",
+    partialPoints: false
+  });
+  const assessmentJson = {
+    type: "test",
+    taskId,
+    source: {
+      name: p.name ?? fn,
+      showName: false,
+      instructions: "**Submit your work for evaluation**",
+      command: "python /usr/share/codio/assessments/assessments.py",
+      codeEnvConfig,
+      pythonPath: join3(workspace, "code", "functions"),
+      timeoutSeconds: p.timeoutSeconds,
+      guidance: p.guidance,
+      showGuidanceAfterResponseOption: { type: "Never" },
+      maxAttemptsCount: p.maxAttemptsCount,
+      points: p.points,
+      arePartialPointsAllowed: false,
+      useMaximumScore: false,
+      metadata: {
+        tags: [{ name: "Assessment Type", value: "Advanced Code Test" }],
+        files: [studentFilePath],
+        opened: [{ type: "file", panelNumber: 0, content: studentFilePath }]
+      },
+      bloomsObjectiveLevel: p.blooms,
+      learningObjectives: p.lo
+    }
+  };
+  const probeButtonCommand = `python3 ${probeScriptPath}`;
+  const runButtonCommand = `python3 ${studentFilePath}`;
+  const embedLine = `{Check It!|assessment}(${taskId})`;
+  const suggestedPageMarkdown = [
+    `${p.problemStatement}`,
+    ``,
+    `#### Probing the solution to find edge cases`,
+    ``,
+    `You have the ability to 'probe' the solution. Modify the values in \`${p.inputVariable}\` to check the *expected* return value and discover edge cases. You will see the results of all your inputs.`,
+    ``,
+    `|||warning`,
+    `## \`${fn}\` code`,
+    ``,
+    `Probing the solution will run the code in the editor. If the code in your file has syntax errors, probing will not work.`,
+    ``,
+    `Pro-tip: Leave only the \`pass\` keyword in the \`${fn}\` function while probing.`,
+    `|||`,
+    ``,
+    `{Probe Solution}(${probeButtonCommand})`,
+    ``,
+    ``,
+    `## Complete the function`,
+    ``,
+    `Now that you have probed the solution, write your code and complete the \`${fn}\` function.`,
+    ``,
+    `{Run it !}(${runButtonCommand})`,
+    ``,
+    `${embedLine}`
+  ].join(`
+`);
+  return {
+    taskId,
+    jsonPath: "",
+    embedLine,
+    studentFilePath,
+    probeScriptPath,
+    unitTestPath,
+    probeButtonCommand,
+    runButtonCommand,
+    suggestedPageMarkdown,
+    json: assessmentJson,
+    studentFileContent,
+    probeScriptContent,
+    unitTestContent: p.unitTests
+  };
+}
 var createAssessmentInputSchema = z2.discriminatedUnion("type", [
   z2.object({
     type: z2.literal("multiple-choice"),
@@ -46833,6 +47015,11 @@ var createAssessmentInputSchema = z2.discriminatedUnion("type", [
     type: z2.literal("llm-based-auto-rubric"),
     workspace: z2.string().min(1),
     payload: z2.unknown()
+  }),
+  z2.object({
+    type: z2.literal("probeable-question-act"),
+    workspace: z2.string().min(1),
+    payload: z2.unknown()
   })
 ]);
 async function createAssessmentHandler(raw) {
@@ -46873,6 +47060,28 @@ async function createAssessmentHandler(raw) {
     name = json.source.name || taskId;
     const parsed = llmAutoRubricPayloadSchema.parse(input.payload);
     llmSolutions = parsed.solutions;
+  } else if (input.type === "probeable-question-act") {
+    const taskId = generateTaskId("probeable-question-act");
+    const built = buildProbeableAssessment(input.payload, taskId, workspace);
+    const jsonPath2 = join3(assessments, `${taskId}.json`);
+    try {
+      writeFileSync(jsonPath2, `${JSON.stringify(built.json, null, 2)}
+`, { flag: "wx" });
+    } catch (err) {
+      if (err.code === "EEXIST")
+        throw new Error(`taskId collision at ${jsonPath2}`);
+      throw err;
+    }
+    const studentAbs = join3(workspace, built.studentFilePath);
+    mkdirSync(dirname(studentAbs), { recursive: true });
+    writeFileSync(studentAbs, built.studentFileContent, { flag: "wx" });
+    const probeAbs = join3(workspace, built.probeScriptPath);
+    mkdirSync(dirname(probeAbs), { recursive: true });
+    writeFileSync(probeAbs, built.probeScriptContent, { flag: "wx" });
+    const unitTestAbs = join3(workspace, built.unitTestPath);
+    mkdirSync(dirname(unitTestAbs), { recursive: true });
+    writeFileSync(unitTestAbs, built.unitTestContent, { flag: "wx" });
+    return { ...built, jsonPath: jsonPath2 };
   } else {
     throw new Error(`unsupported assessment type: ${input.type}`);
   }
@@ -47034,21 +47243,53 @@ ${freezeErrors.join(`
 // src/tools/fetch-course.ts
 import { execFile } from "node:child_process";
 import {
-  existsSync as existsSync3,
+  copyFileSync,
+  existsSync as existsSync4,
   mkdirSync as mkdirSync2,
   readdirSync,
   rmSync,
   statSync,
   unlinkSync as unlinkSync2
 } from "node:fs";
-import { writeFile, mkdir } from "node:fs/promises";
+import { mkdir, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { dirname as dirname2, join as join5, relative } from "node:path";
+import { dirname as dirname3, join as join6 } from "node:path";
 import { promisify } from "node:util";
 import { z as z4 } from "zod";
+
+// src/utils/load-env.ts
+import { existsSync as existsSync3, readFileSync as readFileSync2 } from "node:fs";
+import { dirname as dirname2, join as join5 } from "node:path";
+function loadEnvWalkUp(startDir) {
+  let dir = startDir.replace(/\/+$/, "");
+  while (true) {
+    const candidate = join5(dir, ".env");
+    if (existsSync3(candidate)) {
+      for (const line of readFileSync2(candidate, "utf8").split(`
+`)) {
+        const t = line.trim();
+        if (!t || t.startsWith("#"))
+          continue;
+        const eq = t.indexOf("=");
+        if (eq < 1)
+          continue;
+        const key = t.slice(0, eq).trim();
+        const val = t.slice(eq + 1).trim().replace(/^(['"])(.*)\1$/, "$2");
+        process.env[key] = val;
+      }
+      return;
+    }
+    const parent = dirname2(dir);
+    if (parent === dir)
+      return;
+    dir = parent;
+  }
+}
+
+// src/tools/fetch-course.ts
 var execFileAsync = promisify(execFile);
 var fetchCourseInputSchema = z4.object({
-  workspace: z4.string().min(1).describe("Absolute path to the Codio workspace root"),
+  workspace: z4.string().optional().describe("Absolute path to the Codio workspace root (defaults to current working directory)"),
   courseId: z4.string().min(1).describe("Codio course ID (32-char hex)"),
   outputDir: z4.string().optional().describe("Output folder name inside workspace (default: course-project)"),
   domain: z4.string().optional().describe("Codio domain (default: codio.com)")
@@ -47063,7 +47304,7 @@ async function extractZip(zipPath, destDir) {
 function findTarZstFiles(dir) {
   const results = [];
   for (const name of readdirSync(dir)) {
-    const full = join5(dir, name);
+    const full = join6(dir, name);
     if (statSync(full).isDirectory())
       results.push(...findTarZstFiles(full));
     else if (name.endsWith(".tar.zst"))
@@ -47080,10 +47321,10 @@ async function extractTarZstArchives(stagingDir) {
   }
 }
 function removeExportedReadmes(dir) {
-  if (!existsSync3(dir))
+  if (!existsSync4(dir))
     return;
   for (const name of readdirSync(dir)) {
-    const full = join5(dir, name);
+    const full = join6(dir, name);
     if (statSync(full).isDirectory())
       removeExportedReadmes(full);
     else if (name.toLowerCase() === "readme.md")
@@ -47093,18 +47334,18 @@ function removeExportedReadmes(dir) {
 function copyDir(src, dst) {
   mkdirSync2(dst, { recursive: true });
   for (const name of readdirSync(src)) {
-    const srcPath = join5(src, name);
-    const dstPath = join5(dst, name);
+    const srcPath = join6(src, name);
+    const dstPath = join6(dst, name);
     if (statSync(srcPath).isDirectory())
       copyDir(srcPath, dstPath);
-    else {
-      const { copyFileSync } = __require("node:fs");
+    else
       copyFileSync(srcPath, dstPath);
-    }
   }
 }
 async function fetchCourseHandler(raw) {
   const input = fetchCourseInputSchema.parse(raw);
+  const workspace = input.workspace?.trim() || process.cwd();
+  loadEnvWalkUp(workspace);
   const [{ default: codio }, { json2csv }] = await Promise.all([
     Promise.resolve().then(() => __toESM(require_lib3(), 1)),
     Promise.resolve().then(() => __toESM(require_converter(), 1))
@@ -47112,14 +47353,14 @@ async function fetchCourseHandler(raw) {
   const clientId = process.env["CODIO_CLIENT_ID"];
   const clientSecret = process.env["CODIO_CLIENT_SECRET"];
   if (!clientId || !clientSecret) {
-    throw new Error("CODIO_CLIENT_ID and CODIO_CLIENT_SECRET must be set as environment variables on the box.");
+    throw new Error("CODIO_CLIENT_ID and CODIO_CLIENT_SECRET must be set in .env at the workspace root or as environment variables.");
   }
   const domain = input.domain ?? process.env["CODIO_DOMAIN"] ?? "codio.com";
   const outputFolderName = input.outputDir ?? "course-project";
-  const outputDir = join5(input.workspace, outputFolderName);
-  const contentDir = join5(outputDir, "course-content");
-  const manifestPath = join5(outputDir, "course-manifest.json");
-  const csvPath = join5(outputDir, "course-assignments.csv");
+  const outputDir = join6(workspace, outputFolderName);
+  const contentDir = join6(outputDir, "course-content");
+  const manifestPath = join6(outputDir, "course-manifest.json");
+  const csvPath = join6(outputDir, "course-assignments.csv");
   codio.v1.setDomain(domain);
   await codio.v1.auth(clientId, clientSecret);
   const courseInfo = await codio.v1.course.info(input.courseId);
@@ -47158,7 +47399,7 @@ async function fetchCourseHandler(raw) {
   };
   rmSync(outputDir, { recursive: true, force: true });
   mkdirSync2(contentDir, { recursive: true });
-  await mkdir(dirname2(manifestPath), { recursive: true });
+  await mkdir(dirname3(manifestPath), { recursive: true });
   await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}
 `, "utf8");
   const rows = modules.flatMap((m) => m.assignments.map((a) => ({
@@ -47170,14 +47411,14 @@ async function fetchCourseHandler(raw) {
     assignmentFolder: a.folder,
     assignmentPath: a.path
   })));
-  const csv = await json2csv(rows, { emptyFieldValue: "", prependHeader: true });
+  const csv = json2csv(rows, { emptyFieldValue: "", prependHeader: true });
   await writeFile(csvPath, csv, "utf8");
-  const workDir = join5(tmpdir(), `codio-fetch-${Date.now()}`);
-  const zipPath = join5(workDir, "course-export.zip");
+  const workDir = join6(tmpdir(), `codio-fetch-${Date.now()}`);
+  const zipPath = join6(workDir, "course-export.zip");
   mkdirSync2(workDir, { recursive: true });
   try {
     await codio.v1.course.downloadSourceExport(input.courseId, zipPath);
-    const stagingDir = join5(workDir, "staging");
+    const stagingDir = join6(workDir, "staging");
     await extractZip(zipPath, stagingDir);
     await extractTarZstArchives(stagingDir);
     removeExportedReadmes(stagingDir);
@@ -47197,15 +47438,16 @@ async function fetchCourseHandler(raw) {
 // src/tools/publish-course.ts
 import { createHash } from "node:crypto";
 import {
-  existsSync as existsSync4,
+  existsSync as existsSync5,
   readdirSync as readdirSync2,
-  readFileSync as readFileSync2,
-  writeFileSync as writeFileSync4
+  readFileSync as readFileSync3,
+  writeFileSync as writeFileSync3
 } from "node:fs";
-import { join as join6, relative as relative2 } from "node:path";
+import { join as join7, relative } from "node:path";
 import { z as z5 } from "zod";
 var DEFAULT_STACK = "e0195698-d647-4490-8834-350583b532eb:latest";
 var publishCourseInputSchema = z5.object({
+  workspace: z5.string().optional().describe("Absolute path to the Codio workspace root where .env lives (defaults to current working directory)"),
   manifestPath: z5.string().min(1).describe("Absolute path to course-manifest.json"),
   dryRun: z5.boolean().optional().describe("Preview actions without making changes"),
   force: z5.boolean().optional().describe("Publish all, bypassing change detection"),
@@ -47215,17 +47457,17 @@ var publishCourseInputSchema = z5.object({
   stack: z5.string().optional().describe("Force a specific stack ID for all assignments")
 });
 function saveManifest(manifestPath, manifest) {
-  writeFileSync4(manifestPath, `${JSON.stringify(manifest, null, 2)}
+  writeFileSync3(manifestPath, `${JSON.stringify(manifest, null, 2)}
 `, "utf8");
 }
 function findZip(dir) {
   const zip = readdirSync2(dir).find((f) => f.endsWith(".zip"));
-  return zip ? join6(dir, zip) : null;
+  return zip ? join7(dir, zip) : null;
 }
 function walkFiles(dir) {
   const results = [];
   for (const entry of readdirSync2(dir, { withFileTypes: true })) {
-    const full = join6(dir, entry.name);
+    const full = join7(dir, entry.name);
     if (entry.isDirectory())
       results.push(...walkFiles(full));
     else
@@ -47237,12 +47479,12 @@ function computeContentHash(dir) {
   const hash = createHash("sha256");
   const zipPath = findZip(dir);
   if (zipPath) {
-    hash.update(readFileSync2(zipPath));
+    hash.update(readFileSync3(zipPath));
   } else {
     for (const file of walkFiles(dir).sort()) {
-      hash.update(relative2(dir, file));
+      hash.update(relative(dir, file));
       hash.update("\x00");
-      hash.update(readFileSync2(file));
+      hash.update(readFileSync3(file));
       hash.update("\x00");
     }
   }
@@ -47250,20 +47492,22 @@ function computeContentHash(dir) {
 }
 async function publishCourseHandler(raw) {
   const input = publishCourseInputSchema.parse(raw);
+  const workspace = input.workspace?.trim() || process.cwd();
+  loadEnvWalkUp(workspace);
   const { default: codio } = await Promise.resolve().then(() => __toESM(require_lib3(), 1));
   const clientId = process.env["CODIO_CLIENT_ID"];
   const clientSecret = process.env["CODIO_CLIENT_SECRET"];
   if (!clientId || !clientSecret) {
     throw new Error("CODIO_CLIENT_ID and CODIO_CLIENT_SECRET must be set as environment variables on the box.");
   }
-  if (!existsSync4(input.manifestPath)) {
+  if (!existsSync5(input.manifestPath)) {
     throw new Error(`course-manifest.json not found at ${input.manifestPath}`);
   }
   const domain = process.env["CODIO_DOMAIN"] ?? "codio.com";
   codio.v1.setDomain(domain);
   await codio.v1.auth(clientId, clientSecret);
-  const manifest = JSON.parse(readFileSync2(input.manifestPath, "utf8"));
-  const manifestDir = join6(input.manifestPath, "..");
+  const manifest = JSON.parse(readFileSync3(input.manifestPath, "utf8"));
+  const manifestDir = join7(input.manifestPath, "..");
   if (!manifest.courseId) {
     const courseName = manifest.courseName ?? "Codio Course";
     if (input.dryRun) {
@@ -47305,8 +47549,8 @@ async function publishCourseHandler(raw) {
     for (const asgn of mod.assignments) {
       if (input.assignment && asgn.name !== input.assignment && asgn.folder !== input.assignment)
         continue;
-      const asgnAbsPath = join6(manifestDir, asgn.path);
-      if (!existsSync4(asgnAbsPath)) {
+      const asgnAbsPath = join7(manifestDir, asgn.path);
+      if (!existsSync5(asgnAbsPath)) {
         skipped++;
         continue;
       }
@@ -47360,19 +47604,19 @@ async function publishCourseHandler(raw) {
 }
 
 // src/tools/validate-guide.ts
-import { existsSync as existsSync5, readdirSync as readdirSync3, readFileSync as readFileSync3, statSync as statSync3 } from "node:fs";
-import { join as join7, relative as relative3 } from "node:path";
+import { existsSync as existsSync6, readdirSync as readdirSync3, readFileSync as readFileSync4, statSync as statSync2 } from "node:fs";
+import { join as join8, relative as relative2 } from "node:path";
 import { z as z6 } from "zod";
 var validateGuideInputSchema = z6.object({
   workspace: z6.string().min(1)
 });
 function walkJsonFiles(root) {
-  if (!existsSync5(root))
+  if (!existsSync6(root))
     return [];
   const out = [];
   for (const name of readdirSync3(root)) {
-    const p = join7(root, name);
-    const s = statSync3(p);
+    const p = join8(root, name);
+    const s = statSync2(p);
     if (s.isDirectory())
       out.push(...walkJsonFiles(p));
     else if (name.endsWith(".json"))
@@ -47398,12 +47642,12 @@ var LANG_COMMENT_PREFIX2 = {
   sql: "--"
 };
 function walkMdFiles(root) {
-  if (!existsSync5(root))
+  if (!existsSync6(root))
     return [];
   const out = [];
   for (const name of readdirSync3(root)) {
-    const p = join7(root, name);
-    const s = statSync3(p);
+    const p = join8(root, name);
+    const s = statSync2(p);
     if (s.isDirectory())
       out.push(...walkMdFiles(p));
     else if (name.endsWith(".md"))
@@ -47476,7 +47720,7 @@ async function validateGuideHandler(raw) {
     directory: input.workspace
   });
   const findings = [];
-  if (!existsSync5(content)) {
+  if (!existsSync6(content)) {
     findings.push({
       category: "missing_content_dir",
       detail: `${content} does not exist`,
@@ -47487,7 +47731,7 @@ async function validateGuideHandler(raw) {
   for (const f of walkJsonFiles(guides)) {
     let parsed;
     try {
-      parsed = JSON.parse(readFileSync3(f, "utf8"));
+      parsed = JSON.parse(readFileSync4(f, "utf8"));
     } catch {
       continue;
     }
@@ -47497,7 +47741,7 @@ async function validateGuideHandler(raw) {
       if (!isUuidV4(id)) {
         findings.push({
           category: "invalid_uuid",
-          detail: `${relative3(input.workspace, f)}: ${id}`,
+          detail: `${relative2(input.workspace, f)}: ${id}`,
           severity: "error"
         });
       }
@@ -47508,45 +47752,45 @@ async function validateGuideHandler(raw) {
       continue;
     let parsed;
     try {
-      parsed = JSON.parse(readFileSync3(f, "utf8"));
+      parsed = JSON.parse(readFileSync4(f, "utf8"));
     } catch {
       continue;
     }
     const base = f.slice(0, -"/index.json".length);
     for (const stem of parsed?.order ?? []) {
-      const jsonPair = existsSync5(join7(base, `${stem}.json`)) && existsSync5(join7(base, `${stem}.md`));
-      const chapter = existsSync5(join7(base, stem, "index.json"));
+      const jsonPair = existsSync6(join8(base, `${stem}.json`)) && existsSync6(join8(base, `${stem}.md`));
+      const chapter = existsSync6(join8(base, stem, "index.json"));
       if (!jsonPair && !chapter) {
         findings.push({
           category: "orphan_order_stem",
-          detail: `${relative3(input.workspace, f)} references missing stem '${stem}'`,
+          detail: `${relative2(input.workspace, f)} references missing stem '${stem}'`,
           severity: "error"
         });
       }
     }
   }
   for (const md of walkMdFiles(content)) {
-    const body = readFileSync3(md, "utf8");
+    const body = readFileSync4(md, "utf8");
     const re = new RegExp(ANY_TASKID_RE.source, "g");
     for (const match of body.matchAll(re)) {
       const tid = match[0];
-      if (!existsSync5(join7(assessments, `${tid}.json`))) {
+      if (!existsSync6(join8(assessments, `${tid}.json`))) {
         findings.push({
           category: "broken_assessment_ref",
-          detail: `${relative3(input.workspace, md)} references missing ${tid}.json`,
+          detail: `${relative2(input.workspace, md)} references missing ${tid}.json`,
           severity: "error"
         });
       }
     }
   }
-  if (existsSync5(assessments)) {
+  if (existsSync6(assessments)) {
     for (const f of walkJsonFiles(assessments)) {
       if (!f.endsWith(".json"))
         continue;
       const expected = f.split("/").pop().replace(/\.json$/, "");
       let parsed;
       try {
-        parsed = JSON.parse(readFileSync3(f, "utf8"));
+        parsed = JSON.parse(readFileSync4(f, "utf8"));
       } catch {
         continue;
       }
@@ -47554,7 +47798,7 @@ async function validateGuideHandler(raw) {
       if (expected !== actual) {
         findings.push({
           category: "taskid_filename_mismatch",
-          detail: `${relative3(input.workspace, f)}: filename '${expected}' vs taskId '${actual}'`,
+          detail: `${relative2(input.workspace, f)}: filename '${expected}' vs taskId '${actual}'`,
           severity: "error"
         });
       }
@@ -47565,7 +47809,7 @@ async function validateGuideHandler(raw) {
       continue;
     let pageTitle;
     try {
-      const parsed = JSON.parse(readFileSync3(f, "utf8"));
+      const parsed = JSON.parse(readFileSync4(f, "utf8"));
       pageTitle = parsed?.title;
     } catch {
       continue;
@@ -47573,34 +47817,34 @@ async function validateGuideHandler(raw) {
     if (!pageTitle)
       continue;
     const mdPath = f.replace(/\.json$/, ".md");
-    if (!existsSync5(mdPath))
+    if (!existsSync6(mdPath))
       continue;
-    const body = readFileSync3(mdPath, "utf8");
+    const body = readFileSync4(mdPath, "utf8");
     const firstH1 = findFirstH1(body);
     if (firstH1 && firstH1 === pageTitle) {
       findings.push({
         category: "double_header",
-        detail: `${relative3(input.workspace, mdPath)}: first H1 "${firstH1}" duplicates page title — remove H1 from body`,
+        detail: `${relative2(input.workspace, mdPath)}: first H1 "${firstH1}" duplicates page title — remove H1 from body`,
         severity: "warning"
       });
     }
   }
   for (const md of walkMdFiles(content)) {
-    const body = readFileSync3(md, "utf8");
+    const body = readFileSync4(md, "utf8");
     for (const err of checkFreezeDirectives(body)) {
       findings.push({
         category: "freeze_syntax_error",
-        detail: `${relative3(input.workspace, md)}: ${err}`,
+        detail: `${relative2(input.workspace, md)}: ${err}`,
         severity: "error"
       });
     }
   }
   for (const md of walkMdFiles(content)) {
-    const body = readFileSync3(md, "utf8");
+    const body = readFileSync4(md, "utf8");
     for (const err of findMalformedTryIt(body)) {
       findings.push({
         category: "try_it_syntax_error",
-        detail: `${relative3(input.workspace, md)}: ${err}`,
+        detail: `${relative2(input.workspace, md)}: ${err}`,
         severity: "error"
       });
     }
@@ -47610,7 +47854,7 @@ async function validateGuideHandler(raw) {
       continue;
     let parsed;
     try {
-      parsed = JSON.parse(readFileSync3(f, "utf8"));
+      parsed = JSON.parse(readFileSync4(f, "utf8"));
     } catch {
       continue;
     }
@@ -47618,10 +47862,10 @@ async function validateGuideHandler(raw) {
       const filePath = entry?.path;
       if (!filePath)
         continue;
-      if (!existsSync5(join7(input.workspace, filePath))) {
+      if (!existsSync6(join8(input.workspace, filePath))) {
         findings.push({
           category: "missing_referenced_file",
-          detail: `${relative3(input.workspace, f)}: references file "${filePath}" which does not exist in workspace`,
+          detail: `${relative2(input.workspace, f)}: references file "${filePath}" which does not exist in workspace`,
           severity: "warning"
         });
       }
@@ -47640,9 +47884,9 @@ var create_page = tool({
   }
 });
 var create_assessment = tool({
-  description: "Create a Codio assessment JSON of type multiple-choice, code-output-compare, or fill-in-the-blanks. Generates the taskId, writes to .guides/assessments/, returns { taskId, jsonPath, embedLine }.",
+  description: "Create a Codio assessment. Type options: multiple-choice, code-output-compare, fill-in-the-blanks, parsons-puzzle, llm-based-auto-rubric, probeable-question-act. Returns { taskId, jsonPath, embedLine } for standard types. For probeable-question-act also returns { studentFilePath, probeScriptPath, probeButtonCommand, runButtonCommand, suggestedPageMarkdown } and writes student file, probe script, and unit test file.",
   args: {
-    type: tool.schema.enum(["multiple-choice", "code-output-compare", "fill-in-the-blanks"]).describe("Assessment type"),
+    type: tool.schema.enum(["multiple-choice", "code-output-compare", "fill-in-the-blanks", "parsons-puzzle", "llm-based-auto-rubric", "probeable-question-act"]).describe("Assessment type"),
     workspace: tool.schema.string().min(1).describe("Absolute path to the Codio workspace root"),
     payload: tool.schema.unknown().describe("Assessment payload object (type-specific fields)")
   },
@@ -47665,7 +47909,7 @@ var fetch_course = tool({
   }
 });
 var publish_course = tool({
-  description: "Publish Codio course assignments to the platform. Reads course-manifest.json, creates missing courses/modules/assignments, and publishes each one. Skips unchanged assignments by content hash. Returns { published, created, unchanged, skipped }.",
+  description: "Publish Codio course assignments to the platform. Reads course-manifest.json from manifestPath, creates missing courses/modules/assignments, and publishes each one. Skips unchanged assignments by content hash. Returns { published, created, unchanged, skipped }.",
   args: publishCourseInputSchema.shape,
   async execute(args) {
     return JSON.stringify(await publishCourseHandler(args));
@@ -47735,7 +47979,13 @@ var CodioAuthoringPlugin = async (ctx) => {
         return;
       const orchestratorDef = agentDefs.find((a) => a.name === "codio-orchestrator");
       const orchestratorPrompt = typeof orchestratorDef?.config?.prompt === "string" ? orchestratorDef.config.prompt : buildOrchestratorPrompt(disabledAgents);
-      output.system[0] = orchestratorPrompt + (output.system[0] ? `
+      const workspaceBlock = `<Workspace>
+Workspace root: ${ctx.directory}
+Always pass this exact path as the \`workspace\` argument to all tools.
+</Workspace>`;
+      output.system[0] = orchestratorPrompt + `
+
+${workspaceBlock}` + (output.system[0] ? `
 
 ${output.system[0]}` : "");
     }

package/dist/tools/create-assessment.d.ts

@@ -279,6 +279,35 @@ export interface LlmAutoRubricAssessmentJson {
     };
 }
 export declare function buildLlmAutoRubricAssessment(raw: unknown, taskId?: string): LlmAutoRubricAssessmentJson;
+export declare const probeablePayloadSchema: z.ZodObject<{
+    functionName: z.ZodString;
+    functionSignature: z.ZodString;
+    problemStatement: z.ZodString;
+    inputVariable: z.ZodString;
+    inputVariableAnnotation: z.ZodString;
+    defaultInputValue: z.ZodString;
+    referenceSolution: z.ZodString;
+    unitTests: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    points: z.ZodDefault<z.ZodNumber>;
+    maxAttemptsCount: z.ZodDefault<z.ZodNumber>;
+    timeoutSeconds: z.ZodDefault<z.ZodNumber>;
+    guidance: z.ZodDefault<z.ZodString>;
+    lo: z.ZodDefault<z.ZodString>;
+    blooms: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type ProbeablePayload = z.infer<typeof probeablePayloadSchema>;
+export interface ProbeableCreateResult {
+    taskId: string;
+    jsonPath: string;
+    embedLine: string;
+    studentFilePath: string;
+    probeScriptPath: string;
+    unitTestPath: string;
+    probeButtonCommand: string;
+    runButtonCommand: string;
+    suggestedPageMarkdown: string;
+}
 export declare const createAssessmentInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"multiple-choice">;
     workspace: z.ZodString;
@@ -299,12 +328,16 @@ export declare const createAssessmentInputSchema: z.ZodDiscriminatedUnion<[z.Zod
     type: z.ZodLiteral<"llm-based-auto-rubric">;
     workspace: z.ZodString;
     payload: z.ZodUnknown;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"probeable-question-act">;
+    workspace: z.ZodString;
+    payload: z.ZodUnknown;
 }, z.core.$strip>], "type">;
-export interface CreateAssessmentResult {
+export type CreateAssessmentResult = {
     taskId: string;
     jsonPath: string;
     embedLine: string;
-}
+} | ProbeableCreateResult;
 export declare function createAssessmentHandler(raw: unknown): Promise<CreateAssessmentResult>;
 export {};
 //# sourceMappingURL=create-assessment.d.ts.map

package/dist/tools/create-assessment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-assessment.d.ts","sourceRoot":"","sources":["../../src/tools/create-assessment.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"create-assessment.d.ts","sourceRoot":"","sources":["../../src/tools/create-assessment.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAkBD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;iBAqBzB,CAAC;AAEL,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,OAAO,CAAC;QAC1B,YAAY,EAAE,OAAO,CAAC;QACtB,OAAO,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,OAAO,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAClE,QAAQ,EAAE;YAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YAAC,KAAK,EAAE,MAAM,EAAE,CAAC;YAAC,MAAM,EAAE,OAAO,EAAE,CAAA;SAAE,CAAC;QACtE,oBAAoB,EAAE,MAAM,CAAC;QAC7B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,QAAQ,EAAE,MAAM,CAAC;QACjB,+BAA+B,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC;QACtE,gBAAgB,EAAE,MAAM,CAAC;QACzB,wBAAwB,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3C,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,MAAM,CAAC;QACxB,uBAAuB,EAAE,OAAO,CAAC;QACjC,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;CACH;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,EACZ,MAAM,GAAE,MAA0C,GACjD,iBAAiB,CAiCnB;AAID,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2ChC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,OAAO,EACZ,MAAM,GAAE,MAA8C,GACrD,sBAAsB,CAsCxB;AAMD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG;IAC1C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;CACzB,CAcA;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;iBAoB1B,CAAC;AAEL,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,OAAO,EACZ,MAAM,GAAE,MAA6C,GACpD,kBAAkB,CA8BpB;AAID,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAU/B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAe/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE;YAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YAAC,KAAK,EAAE,MAAM,EAAE,CAAC;YAAC,MAAM,EAAE,OAAO,EAAE,CAAA;SAAE,CAAC;QACtE,oBAAoB,EAAE,MAAM,CAAC;QAC7B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,QAAQ,EAAE,MAAM,CAAC;QACjB,+BAA+B,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC;QACtE,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;CACH;AAED,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,OAAO,EACZ,MAAM,GAAE,MAAyC,GAChD,qBAAqB,CA8BvB;AAID,eAAO,MAAM,yBAAyB;;;;;iBAKpC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;iBAGtC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgBrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,uBAAuB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE;YACR,IAAI,EAAE,WAAW,EAAE,CAAC;YACpB,KAAK,EAAE,MAAM,EAAE,CAAC;YAChB,MAAM,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,WAAW,EAAE,MAAM,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SACvE,CAAC;QACF,oBAAoB,EAAE,MAAM,CAAC;QAC7B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,QAAQ,EAAE,MAAM,CAAC;QACjB,+BAA+B,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC;QACtE,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,uBAAuB,EAAE,OAAO,CAAC;QACjC,OAAO,EAAE,KAAK,CAAC;YACb,EAAE,EAAE,MAAM,CAAC;YACX,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,EAAE,MAAM,CAAC;YACpB,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC,CAAC;QACH,mBAAmB,EAAE,MAAM,CAAC;QAC5B,SAAS,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACrD,CAAC;CACH;AAED,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,OAAO,EACZ,MAAM,GAAE,MAAgD,GACvD,2BAA2B,CAuC7B;AAID,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;iBAgBjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAwKD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;2BA+BtC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAC9B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACvD,qBAAqB,CAAC;AAE1B,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,sBAAsB,CAAC,CA6GjC"}

package/dist/tools/fetch-course.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 export declare const fetchCourseInputSchema: z.ZodObject<{
-    workspace: z.ZodString;
+    workspace: z.ZodOptional<z.ZodString>;
     courseId: z.ZodString;
     outputDir: z.ZodOptional<z.ZodString>;
     domain: z.ZodOptional<z.ZodString>;

package/dist/tools/fetch-course.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-course.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-course.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,sBAAsB;;;;;iBAQjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAoED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0GjF"}
+{"version":3,"file":"fetch-course.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-course.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,sBAAsB;;;;;iBAQjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAyDD,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA+GjF"}

package/dist/tools/index.d.ts

@@ -39,12 +39,15 @@ export declare const create_assessment: {
             "multiple-choice": "multiple-choice";
             "code-output-compare": "code-output-compare";
             "fill-in-the-blanks": "fill-in-the-blanks";
+            "parsons-puzzle": "parsons-puzzle";
+            "llm-based-auto-rubric": "llm-based-auto-rubric";
+            "probeable-question-act": "probeable-question-act";
         }>;
         workspace: import("zod").ZodString;
         payload: import("zod").ZodUnknown;
     };
     execute(args: {
-        type: "multiple-choice" | "code-output-compare" | "fill-in-the-blanks";
+        type: "multiple-choice" | "code-output-compare" | "fill-in-the-blanks" | "parsons-puzzle" | "llm-based-auto-rubric" | "probeable-question-act";
         workspace: string;
         payload: unknown;
     }, context: import("@opencode-ai/plugin").ToolContext): Promise<import("@opencode-ai/plugin").ToolResult>;
@@ -61,14 +64,14 @@ export declare const validate_guide: {
 export declare const fetch_course: {
     description: string;
     args: {
-        workspace: import("zod").ZodString;
+        workspace: import("zod").ZodOptional<import("zod").ZodString>;
         courseId: import("zod").ZodString;
         outputDir: import("zod").ZodOptional<import("zod").ZodString>;
         domain: import("zod").ZodOptional<import("zod").ZodString>;
     };
     execute(args: {
-        workspace: string;
         courseId: string;
+        workspace?: string | undefined;
         outputDir?: string | undefined;
         domain?: string | undefined;
     }, context: import("@opencode-ai/plugin").ToolContext): Promise<import("@opencode-ai/plugin").ToolResult>;
@@ -76,6 +79,7 @@ export declare const fetch_course: {
 export declare const publish_course: {
     description: string;
     args: {
+        workspace: import("zod").ZodOptional<import("zod").ZodString>;
         manifestPath: import("zod").ZodString;
         dryRun: import("zod").ZodOptional<import("zod").ZodBoolean>;
         force: import("zod").ZodOptional<import("zod").ZodBoolean>;
@@ -86,6 +90,7 @@ export declare const publish_course: {
     };
     execute(args: {
         manifestPath: string;
+        workspace?: string | undefined;
         dryRun?: boolean | undefined;
         force?: boolean | undefined;
         module?: string | undefined;

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOtB,CAAC;AAOH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;CAkB5B,CAAC;AAIH,eAAO,MAAM,cAAc;;;;;;;;CAOzB,CAAC;AAIH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;CAOvB,CAAC;AAIH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;CAOzB,CAAC;AAQH,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAMzC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOtB,CAAC;AAOH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;CAkB5B,CAAC;AAIH,eAAO,MAAM,cAAc;;;;;;;;CAOzB,CAAC;AAIH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;CAOvB,CAAC;AAIH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;CAOzB,CAAC;AAQH,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAMzC,CAAC"}

package/dist/tools/publish-course.d.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 export declare const publishCourseInputSchema: z.ZodObject<{
+    workspace: z.ZodOptional<z.ZodString>;
     manifestPath: z.ZodString;
     dryRun: z.ZodOptional<z.ZodBoolean>;
     force: z.ZodOptional<z.ZodBoolean>;

package/dist/tools/publish-course.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publish-course.d.ts","sourceRoot":"","sources":["../../src/tools/publish-course.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,wBAAwB;;;;;;;;iBAQnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AA6DD,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAuHrF"}
+{"version":3,"file":"publish-course.d.ts","sourceRoot":"","sources":["../../src/tools/publish-course.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,wBAAwB;;;;;;;;;iBASnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AA6DD,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA4HrF"}

package/dist/utils/load-env.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Walk up from startDir looking for a .env file.
+ * When found, load it with override semantics — .env values always win
+ * over whatever is already in process.env.
+ */
+export declare function loadEnvWalkUp(startDir: string): void;
+//# sourceMappingURL=load-env.d.ts.map

package/dist/utils/load-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-env.d.ts","sourceRoot":"","sources":["../../src/utils/load-env.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAoBpD"}

package/dist/utils/taskid.d.ts

@@ -1,4 +1,4 @@
-export type AssessmentType = 'multiple-choice' | 'code-output-compare' | 'fill-in-the-blanks' | 'parsons-puzzle' | 'llm-based-auto-rubric';
+export type AssessmentType = 'multiple-choice' | 'code-output-compare' | 'fill-in-the-blanks' | 'parsons-puzzle' | 'llm-based-auto-rubric' | 'probeable-question-act';
 export declare const ASSESSMENT_TYPES: AssessmentType[];
 export declare const ANY_TASKID_RE: RegExp;
 export declare function generateTaskId(type: AssessmentType): string;

package/dist/utils/taskid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"taskid.d.ts","sourceRoot":"","sources":["../../src/utils/taskid.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,qBAAqB,GACrB,oBAAoB,GACpB,gBAAgB,GAChB,uBAAuB,CAAC;AAE5B,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAM5C,CAAC;AAMF,eAAO,MAAM,aAAa,QAGzB,CAAC;AAEF,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAI3D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAKpE"}
+{"version":3,"file":"taskid.d.ts","sourceRoot":"","sources":["../../src/utils/taskid.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,qBAAqB,GACrB,oBAAoB,GACpB,gBAAgB,GAChB,uBAAuB,GACvB,wBAAwB,CAAC;AAE7B,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAO5C,CAAC;AAmBF,eAAO,MAAM,aAAa,QAGzB,CAAC;AAEF,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAK3D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAOpE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codio-ai/opencode-authoring-agent",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Opencode plugin for authoring Codio guide assignments — orchestrator, subagents, tools, and skills.",
   "type": "module",
   "main": "dist/index.js",

package/src/skills/reference-assessment-types/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: reference-assessment-types
-description: Payload field reference for multiple-choice, code-output-compare (Standard Code Test), fill-in-the-blanks, parsons-puzzle, and llm-based-auto-rubric assessments. Use when building any assessment payload.
+description: Payload field reference for multiple-choice, code-output-compare, fill-in-the-blanks, parsons-puzzle, llm-based-auto-rubric, and probeable-question-act assessments. Use when building any assessment payload.
 ---
 
 # Assessment types
@@ -307,3 +307,100 @@ Note: auto-rubric uses `panelNumber` (not `panel`) in the opened entries.
 - All solutions: `.guides/secure/<filename>` — hidden from students.
 - Never: `.guides/content/<anything>` — student-visible.
 - The tool writes the file only if it does not already exist (safe to re-run).
+
+---
+
+## `probeable-question-act` — Probeable Question (Advanced Code Test)
+
+A probeable question combines a guide page with custom buttons and an Advanced Code Test assessment. Students first "probe" the reference solution with their own inputs to discover edge cases, then implement the function themselves.
+
+### What the tool creates
+
+Calling `create_assessment` with `type: 'probeable-question-act'` writes four files and returns an extended result:
+
+| File | Location | Visible to students? |
+|---|---|---|
+| Assessment JSON | `.guides/assessments/test-XXXXXXXXXX.json` | No |
+| Student file | `code/functions/probeable_{functionName}.py` | Yes |
+| Probe script | `.guides/probeable_questions/probe_{functionName}.py` | Yes (by design) |
+| Unit test file | `.guides/secure/unit_tests/probeable_questions/{functionName}_test.py` | No |
+
+The probe script is intentionally student-visible — students click a button to run it with their probe inputs.
+
+### Payload fields
+
+```
+functionName             string   Python function name (snake_case), used as the file stem
+functionSignature        string   Full def line with type hints, e.g. "def min_index(int_list: list[int]) -> int:"
+problemStatement         string   Narrative description for the guide page
+inputVariable            string   Variable students modify to probe, e.g. "int_list"
+inputVariableAnnotation  string   Python type annotation, e.g. "list[int]"
+defaultInputValue        string   Default value shown in student file, e.g. "[1, 2, 3]"
+referenceSolution        string   Complete working function definition (def line + body)
+unitTests                string   Full Python unittest file content
+name?                    string   Display name (defaults to functionName)
+points?                  number   Default 20
+maxAttemptsCount?        number   Default 0 (unlimited)
+timeoutSeconds?          number   Default 40
+guidance?                string   Default ""
+lo?                      string   Learning objective
+blooms?                  string   Bloom's level
+```
+
+### Extended return value
+
+```
+taskId              string   e.g. "test-1234567890"
+jsonPath            string   Absolute path to written assessment JSON
+embedLine           string   '{Check It!|assessment}(test-XXXXXXXXXX)'
+studentFilePath     string   'code/functions/probeable_{functionName}.py'
+probeScriptPath     string   '.guides/probeable_questions/probe_{functionName}.py'
+unitTestPath        string   '.guides/secure/unit_tests/probeable_questions/{functionName}_test.py'
+probeButtonCommand  string   'python3 .guides/probeable_questions/probe_{functionName}.py'
+runButtonCommand    string   'python3 code/functions/probeable_{functionName}.py'
+suggestedPageMarkdown string  Complete guide page markdown — pass to @page-author as body_brief
+```
+
+### Orchestrator workflow
+
+```
+@assessment-author → payload
+  ↓
+create_assessment(type: probeable-question-act) → { taskId, embedLine, suggestedPageMarkdown, ... }
+  ↓
+@page-author (draft mode, body_brief = suggestedPageMarkdown) → markdownBody
+  ↓
+create_page (layout: 2-panels-tree, files: [studentFilePath]) → page JSON + MD
+```
+
+### Guide page structure
+
+The `suggestedPageMarkdown` returned by the tool follows this template — pass it as-is or refine via `@page-author`:
+
+```
+{problemStatement}
+
+#### Probing the solution to find edge cases
+
+Modify {inputVariable} values to check the expected return value and discover edge cases.
+
+|||warning
+## `{functionName}` code
+Probing will run the code in the editor. Syntax errors in your file will prevent probing.
+Pro-tip: Leave only `pass` in the `{functionName}` function while probing.
+|||
+
+{Probe Solution}(python3 .guides/probeable_questions/probe_{functionName}.py)
+
+
+## Complete the function
+
+{Run it !}(python3 code/functions/probeable_{functionName}.py)
+
+{Check It!|assessment}(test-XXXXXXXXXX)
+```
+
+### File naming
+
+Files are named by `functionName` (no sequential exercise numbers). If a student or probe file with the same `functionName` already exists, the tool throws a collision error — choose a unique function name per question.
+