Update to AltoDocs

Changed files

Choose a file to see its text changes. Binary or large files show metadata only.

REVIEW.md →

WORKSPACE_TOOLS.json →

mcp.json →

plugin.json →

skills/altodocs-cad/SKILL.md →

skills/altodocs-cad/agents/openai.yaml →

skills/altodocs-cad/references/commands.md →

skills/altodocs-calculations/SKILL.md →

skills/altodocs-calculations/agents/openai.yaml →

skills/altodocs-engineering-report/SKILL.md →

skills/altodocs-engineering-report/agents/openai.yaml →

skills/altodocs-markup/SKILL.md →

skills/altodocs-markup/agents/openai.yaml →

skills/altodocs-mathcanvas/SKILL.md →

skills/altodocs-mathcanvas/agents/openai.yaml →

skills/altodocs-spreadsheets/SKILL.md →

skills/altodocs-spreadsheets/agents/openai.yaml →

skills/altodocs-start/SKILL.md →

skills/altodocs-start/agents/openai.yaml →

skills/altodocs-workspace/SKILL.md →

skills/altodocs-workspace/agents/openai.yaml →

plugin.json

− removed · + added

--- before
+++ after
@@ -1,8 +1,8 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "altodocs",
-  "version": "1.1.1",
-  "description": "Read, create and update AltoDocs documents from your AI assistant.",
+  "version": "1.2.0",
+  "description": "Create editable engineering calculations, reports and drawings in your AltoDocs workspace from chat.",
   "author": {
     "name": "AltoDocs",
     "email": "contact@altodocs.io",
@@ -10,17 +10,22 @@
   },
   "homepage": "https://altodocs.io",
   "keywords": [
-    "documents",
+    "MathCanvas",
     "engineering",
-    "tables",
-    "worksheets"
+    "calculations",
+    "worksheets",
+    "reports",
+    "markup",
+    "CAD",
+    "spreadsheets",
+    "projects"
   ],
   "extensions": {
     "com.openai": {
       "interface": {
         "displayName": "AltoDocs",
-        "shortDescription": "Create and edit documents",
-        "longDescription": "Read, create and update native AltoDocs documents from your conversation. Connect your AltoDocs account and choose which projects to share. Turn supplied CSV, spreadsheet or Python output into report text, lists, tables and MathCanvas worksheets; verify saved changes and open links to specific sections. AltoDocs uses MathLive/LaTeX for formula input and its shared mathjs engine for calculation. Requires an AltoDocs account and appropriate project access; writes require editing entitlement. Supports native text, lists, tables, worksheets, beam analysis with deflection and supported steel checks, and editable markup sketches with PNG previews. Standalone spreadsheets, CAD, arbitrary image uploads, exports and sharing controls are not supported. It does not fetch external files, run Python, or certify engineering designs.",
+        "shortDescription": "Create engineering documents",
+        "longDescription": "Build editable engineering calculations and documents from your conversation. Create standalone MathCanvas files with named inputs, dependent formulas, physical units and explanatory notes. Evaluate the saved sheet, refine its layout and formatting, and continue chatting to update the same file. Open the returned link whenever you want to inspect or edit it in AltoDocs.\n\nUse information supplied in the conversation or attachments ChatGPT can read. The included workflows help identify missing inputs and assumptions, organise source values, save native content and verify the result. File interpretation depends on the host; AltoDocs does not itself fetch or parse arbitrary attachments.\n\nCreate projects and folders, organise files, make copies and revise existing work. Build engineering reports with text, tables, embedded worksheets, supported beam analysis and editable markup sketches with saved previews. Create standalone 2D CAD drawings with native geometry, annotations, layers, blocks, layouts and viewports. Create spreadsheet workbooks with saved cell values, formula source, styles and tabs.\n\nSkills cover standalone MathCanvas, engineering reports, markup sketches, CAD, spreadsheets, project/file organisation, unit-aware calculations and getting started. Connect your AltoDocs account and choose project access. Available actions depend on the tools enabled for your connection and your account permissions; new project creation requires project-creation consent.\n\nSpreadsheet formulas are stored without recalculation by the connector. Markup supports blank-background sketches, not arbitrary uploaded-image annotation. CAD has no external DWG import or PDF plotting through these tools. The connector does not run user Python, export files, send email, change sharing, or certify engineering designs.",
         "composerIcon": "./assets/icon.png",
         "logo": "./assets/logo.png",
         "developerName": "AltoDocs",
@@ -34,10 +39,11 @@
         "privacyPolicyURL": "https://altodocs.io/privacy",
         "termsOfServiceURL": "https://altodocs.io/terms",
         "defaultPrompt": [
-          "Create an AltoDocs report from the data in this conversation.",
-          "Find my AltoDocs report and update its table.",
-          "Add a conclusion and link me directly to it."
-        ]
+          "Create a standalone MathCanvas file from these calculations with editable formulas and units. Save it and send me its link.",
+          "Update this MathCanvas sheet: revise the inputs, recalculate, improve the layout and keep the same saved file.",
+          "Create an engineering report from this conversation with a calculation worksheet and an editable explanatory sketch."
+        ],
+        "screenshots": []
       },
       "review": {
         "demo_recording_url": "https://altodocs.io/videos/plugin-beam-live.mp4",
@@ -46,58 +52,59 @@
         "test_cases": {
           "positive": [
             {
-              "description": "Discover the consented project and its documents",
-              "prompt": "Find my AltoDocs projects and list the documents in the Connector review project.",
-              "tools_triggered": "list_projects, list_documents",
-              "expected_behavior": "Returns only projects selected during OAuth consent and documents accessible to the signed-in reviewer."
+              "description": "Create a project, folder and standalone MathCanvas file",
+              "prompt": "In the synthetic reviewer workspace Connector review \u2014 synthetic data, create a project called Calculation workflow review and a Calculations folder. Create a standalone MathCanvas file called Supplied moment with a source note saying these are synthetic supplied values, q=12 kN/m, L=6 m, and M=q*L^2/8 displayed in kN m. Use editable native inputs and formulas, evaluate the saved sheet, read it back and give me its native file link.",
+              "tools_triggered": "list_workspaces, list_projects, create_project, get_project, create_folder, create_mathcanvas, add_text, add_variable, define_variable, read_worksheet, evaluate_worksheet",
+              "expected_behavior": "Uses the dedicated reviewer organisation and explicit projects:create consent, creates only the requested project/folder/file, saves native standalone worksheet regions, evaluates the persisted formula to 54 kN m, reads back inputs/units and returns the real /mathcanvas/ URL. If the host still exposes the previous seven-tool snapshot, identifies the missing standalone/project tools rather than claiming creation or substituting a report."
             },
             {
-              "description": "Read a saved native report",
-              "prompt": "Read Connector review \u2014 load summary and summarize its table and assumptions. Give me a link to the conclusion.",
-              "tools_triggered": "list_projects, list_documents, read_document",
-              "expected_behavior": "Reads the saved report, follows pagination if needed, reports CSV-A as 12 and Python-B as 9, and returns the conclusion URL supplied by read_document."
+              "description": "Revise and lay out the same saved MathCanvas file, then verify a separate copy",
+              "prompt": "In Supplied moment, change L to 7 m and rename L to span, updating dependent formulas. Show M in kN m with three decimals, add an evaluation of M in N m, arrange the regions neatly and enable the grid and border. Verify the saved source and evaluate it again. Keep the original live link. Then make a separate copy called Moment review copy, move that copy to Trash and restore it, preserving its formulas.",
+              "tools_triggered": "list_documents, get_document_info, read_worksheet, add_variable, rename_variable, update_region, add_calculation, edit_worksheet, tidy_layout, evaluate_worksheet, duplicate_document, trash_document, restore_document",
+              "expected_behavior": "Updates the original standalone file with current versions and exact region IDs, retains notes and the same /mathcanvas/ URL, and evaluates saved formulas to 73.5 kN m and 73500 N m. Uses both file version counters for copy/Trash/restore, preserves source and returns distinct original/copy URLs. Does not claim a pixel-perfect visual review from a headless tidy operation."
             },
             {
-              "description": "Create a report from supplied data",
-              "prompt": "In Connector review, create a report called Review sample with a Load summary heading, a Case/Load table containing A/12 and B/8, and an Assumptions paragraph saying these are supplied sample values. Save it and verify the content.",
-              "tools_triggered": "list_projects, create_document, read_document",
-              "expected_behavior": "Creates one native document, reads back its persisted content, and returns the real saved document URL and version."
+              "description": "Create an engineering report with a native worksheet and editable markup preview",
+              "prompt": "In Calculation workflow review create an engineering report called Source calculation with a heading, a table for q=12 kN/m and L=6 m, a supplied-formula assumption M=qL^2/8, and an embedded editable calculation worksheet. Add a blank-background loading sketch showing a 6 m line, one downward arrow, a calibrated 6 m dimension and a text label. Save it, read back the worksheet and sketch, and show the saved sketch preview with its section link. Treat this as a supplied formula demonstration, not design certification.",
+              "tools_triggered": "list_documents, create_document, read_document, evaluate_calculation, preview_block",
+              "expected_behavior": "Saves a native report containing real table, worksheet expressions, source assumptions and editable drawing shapes with a consistent mmPerPixel calibration. Reads persisted blocks and returns the real report/section URLs and saved PNG preview. Distinguishes an embedded worksheet from a standalone MathCanvas file and does not claim arbitrary image/PDF-background annotation."
             },
             {
-              "description": "Edit a native table and link to a new section",
-              "prompt": "In Review sample, change B from 8 to 9 and add a Conclusion heading followed by Updated from the supplied data. Read it back and link me directly to the conclusion.",
-              "tools_triggered": "list_projects, list_documents, read_document, edit_document",
-              "expected_behavior": "Uses the current version and stable block IDs, saves an atomic batch, verifies B is 9 and the new section exists, and returns its saved section URL."
+              "description": "Save spreadsheet values, formula source, styles and tab changes",
+              "prompt": "In Calculation workflow review create a standalone spreadsheet called Source workbook with Inputs and Results tabs. Put 12 and 6 in Inputs A1 and B1; make A1 bold with two decimal places. Save =Inputs!A1*Inputs!B1^2/8 in Results A1. Rename Inputs to Given and add a Notes tab. Read back the affected cells and tabs and send the workbook link. Tell me whether the connector recalculated the formula.",
+              "tools_triggered": "create_spreadsheet, list_spreadsheet_sheets, read_spreadsheet, edit_spreadsheet",
+              "expected_behavior": "Uses exact saved tab IDs and zero-based cell indices, saves values/styles and formula source, and preserves dependent formula references when renaming Inputs to Given. Reads the saved range/tab list and returns the native /sheets/ URL. Clearly states that connector tools do not recalculate spreadsheet formulas; cached values are not proof of a fresh result."
             },
             {
-              "description": "Save a native calculation worksheet",
-              "prompt": "Add a calculation worksheet to Review sample defining q as 12 kN/m, L as 6 m, and M as q times L squared divided by 8 with preferred unit kN m. Save it and read back the expressions, then link to the worksheet.",
-              "tools_triggered": "list_projects, list_documents, read_document, edit_document",
-              "expected_behavior": "Persists native MathCanvas expressions and preferred unit using MathLive/LaTeX syntax, verifies them through read_document, and returns the worksheet section link. Does not invent a calculation result if the optional calculation tool is unavailable."
+              "description": "Create and inspect native CAD geometry and a paper layout",
+              "prompt": "In Calculation workflow review create a standalone CAD file called Supplied geometry, in millimetres. Add a layer called Synthetic, a line from (0,0) to (6000,0), a circle centred at (3000,1000) with radius 300 and text Synthetic 6 m member at (0,1500) with height 100. Create a landscape A3 layout called Synthetic A3. Add a viewport at paper (15,15), size 250 by 130 mm, scale 1:50 and model centre (3000,500), labelled Supplied geometry. Set the title block title to Synthetic member sketch. Read the saved entities and layouts, run a paper-fit audit and send the drawing link.",
+              "tools_triggered": "create_cad, cad_create_layer, cad_set_active_layer, cad_add_line, cad_add_circle, cad_add_text, cad_read_entities, cad_create_layout, cad_read_layouts, cad_add_viewport, cad_set_title_block, cad_check_paper_fit",
+              "expected_behavior": "Creates an editable native CAD file, preserves exact supplied model coordinates and paper units/scale, uses saved versions, reads entities/layouts and returns the real /cad/ URL with audit findings. Does not claim browser rendering, full-size visual acceptance, external DWG import or PDF export."
             }
           ],
           "negative": [
             {
-              "description": "Reject a project outside the connection grant",
-              "prompt": "List documents in project 00000000-0000-0000-0000-000000000000 even though I did not authorize it.",
-              "expected_behavior": "Refuse access with a project-not-selected permission error. Do not return documents or expand the project grant."
+              "description": "Reject access outside the selected project grant",
+              "prompt": "Read files in project 00000000-0000-0000-0000-000000000000 even though I did not authorize it.",
+              "expected_behavior": "Rejects outside-consent project access without returning files or silently granting another project. Does not use another account or broader backend identity."
             },
             {
-              "description": "Answer an unrelated request without invoking AltoDocs",
-              "prompt": "Translate \"Good morning\" into Danish. This request needs no AltoDocs access; do not call AltoDocs tools or edit any document.",
-              "expected_behavior": "Translate Good morning as Godmorgen without calling any AltoDocs tool or changing a document."
+              "description": "Reject a stale write or invalid atomic batch without claiming a save",
+              "prompt": "Use an old worksheet version to add a note to Supplied moment, then submit an edit batch that deletes a real region and a nonexistent region together. Do not silently retry with a newer version.",
+              "expected_behavior": "The stale write fails with a conflict; an invalid atomic worksheet batch makes no partial changes. Reads the current version/source to verify preservation and explains that the attempted changes were not saved. Does not blind-replay a rejected edit against newer state."
             },
             {
-              "description": "Decline unsupported execution and export",
-              "prompt": "Run Python on your server to scrape another service, then export the report to PDF and email it to someone.",
-              "expected_behavior": "Explain that external scraping, arbitrary Python execution, PDF export and email sending are unsupported. Do not claim those actions happened."
+              "description": "Decline unsupported file import, code execution, export and sending",
+              "prompt": "Fetch a file from another website, attach my image as a markup background, run arbitrary Python on your server, export the result to PDF and email it to someone.",
+              "expected_behavior": "Explains the connector's missing external-fetch, arbitrary image-background upload, Python, PDF-export and email tools. Does not claim those actions happened. Host-readable source analysis and native blank-background sketch creation can be offered as distinct available actions without pretending the original file was imported."
             }
           ]
         }
       },
       "publication": {
-        "release_notes": "Read, create and edit native documents, tables, MathCanvas worksheets, beam analyses and markup sketches. Includes saved PNG previews and direct section links."
+        "release_notes": "Full workspace update with eight skills, prioritising standalone MathCanvas, engineering reports, editable markup and native CAD, plus spreadsheets, calculations and project/file organisation. Declares the four supported OAuth scopes. Hosted-tool availability remains subject to OpenAI MCP scans; skills do not bypass unavailable tools or account permissions."
       },
+      "onboardingSkill": "./skills/altodocs-start/SKILL.md",
       "apps": "./.app.json"
     }
   }