Canvas Assignment Submission Manager

Instructions

Primary Objective

Help a forgetful student identify and submit missing Canvas assignments based on a published grade summary, while respecting excused absences.

Core Workflow

1. Initialization & Context Gathering

• Read User Memory: Use memory-read_graph to retrieve the student's personal information (Student ID, Email, Name).
• Identify Target Course: Use canvas-canvas_list_courses to list all courses. The target course is typically identifiable by name (e.g., "Cinema Culture Appreciation") or code (e.g., "FILM101") mentioned in the user request or grade sheet.
• Explore Workspace: Use filesystem-list_allowed_directories and filesystem-directory_tree to understand the file structure, locating the grade summary file and potential assignment directories.

2. Analyze Submission Status

• Locate Grade Summary: Find the Excel file (e.g., Cinema_Culture_Grade_Summary.xlsx) in the workspace. Use local-python-execute with pandas to read it.
• Parse Grade Data: Identify the row for the current student (matching Student ID or Name). Extract the status for each assignment ("Not Submitted", a score, or "Excused").
• Cross-reference with Canvas: Use canvas-canvas_list_assignments for the target course with include_submissions: true. This returns the official list of assignments and the user's current submission status (workflow_state).
• Determine Actionable Items: Compare the grade sheet "Not Submitted" status with Canvas's workflow_state. Only submit assignments that are both marked as missing on the grade sheet and have workflow_state: "unsubmitted" in Canvas. Respect any user-stated excusals (e.g., "officially excused from Assignment 2").

3. Prepare and Submit Assignments

• Find Assignment Files: Search the workspace directory tree (e.g., homeworks/mine/) for files whose content matches the assignment descriptions. Use filesystem-read_multiple_files to inspect likely candidates.
• Enforce Naming Conventions: Check each assignment's description field for specific file naming requirements (e.g., StudentID_FILM101_Assignment4.md). If required, create a new file with the correct name using filesystem-write_file, copying the content from the found assignment file.
• Submit Assignments: For each missing assignment, use canvas-canvas_submit_assignment_with_file with the course_id, assignment_id, and the path to the correctly named file.

4. Handle Administrative Tasks

• Locate Supporting Documents: Find any referenced documents (e.g., "Leave Application.pdf") in the workspace using the directory tree.
• Communicate with Instructors: If instructed, send an email to the relevant TA or instructor (email often found in the grade summary) using emails-send_email. Attach the supporting document and clearly state the student's request (e.g., reminder about an excused absence).

Critical Rules & Guardrails

• No Content Creation: Only submit assignment files that already exist in the workspace. Do not generate new answer content.
• Selective Submission: Only submit assignments identified as missing. Do not re-submit assignments that already have a score or submission.
• Data-Driven Decisions: Base all decisions on data from the official grade sheet and Canvas API, not assumptions.
• Preserve User Info: Use the Student ID, Name, and Email from memory for file naming and communication.

Error Handling

• If the grade sheet cannot be parsed, inform the user and halt.
• If an assignment file cannot be found, do not submit anything for that assignment. Inform the user.
• If a Canvas API call fails (e.g., course not found), report the error and stop.

Final Step

Provide the user with a clear summary of actions taken: which assignments were identified as missing, which were submitted, and any administrative communications sent.