Writing code

One screen for code and runs

Open any script from the Code page and the editor fills the window in three columns. On the left, the Inputs card — one field per parameter of main; a script with no parameters has no card. In the middle, the code, with completions and error marks from the language server, and under it the bottom panel with Output, Logs and, while there is something to report, Problems. On the right, the side panel and its tabs.

1def main(name: str = "world"):2    print(f"saying hello to {name}")3    return {"message": f"Hello, {name}!"}

{
  "message": "Hello, world!"
}

Write main()

Every language has the same contract: the platform calls main with the inputs, waits for it to finish and keeps what it returns. Python writes def main(...); TypeScript and JavaScript export async function main(...); C and C++ use the ordinary int main(int argc, char *argv[]), declare inputs with // @param lines, read them with waiso_arg_* (waiso::arg* in C++) and set the result with waiso_set_result (waiso::setResult). The same small script in all five:

def main(text: str = "the quick brown fox"):
    words = text.split()
    print(f"counted {len(words)} words")
    return {"words": len(words), "longest": max(words, key=len) if words else None}

{
  "words": 4,
  "longest": "quick"
}

Parameters become the Inputs card

As soon as you give main a parameter, the Inputs card appears on the left with a typed field for it, and it is redrawn while you type. The type comes from the Python type hint, the TypeScript annotation, the default value (JavaScript) or the // @param name type = default line (C and C++). Fill the fields and press Run. The rules — required or optional, which field each type becomes, how the server checks a value — are in Script inputs.

Results and logs

The return value must be something JSON can hold: a dict or object, a list, text, a number, a boolean or nothing. The Output tab shows it, with JSON view and Table view, Copy JSON, Download JSON and Expand output. What you print or console.log goes to Logs as it happens. When a run fails, read Errors and results.

Save, Run and Publish

1. 1
   Run the code on screen

   Run (or Ctrl+Enter, ⌘+Enter on a Mac) sends the code exactly as it is in the editor — saved or not — with the values in the Inputs card. It is disabled while a required input is empty.

   IdleRun
2. 2
   Save the draft

   Save (Ctrl+S) stores the code as the script’s draft. The button lights up only while there are unsaved changes. Unsaved edits are also kept in this browser: come back later and a banner offers Keep or Discard.

   daily-report.tsunsavedSavePublish
3. 3
   Publish what you tested

   Publish opens a review of everything that changed since the last publish and, on confirm, makes the draft the version schedules, the API and flows run. It is disabled while there are unsaved changes or nothing new to publish.

   daily-report.tsdraftSavePublish

The gear beside Publish, Configuration, holds Version history (browse and compare published versions), Triggers and Overview, the page for running the script without its code.

Panels, toolbar and shortcuts

• Resize the Inputs card (220–480 px) and the side panel (280–640 px) by dragging the seam beside them; the code column never shrinks under 480 px. The widths are remembered for you in this browser.
• Collapse the side panel to a rail of icons; each icon reopens it on its tab. On a first visit to a narrow screen it already starts collapsed, so the code keeps at least 600 px.
• Focus mode — Ctrl+B hides the side panel and the bottom panel; press it again or click Show sidebar & panel.
• Platform SDK in the toolbar opens ready-made snippets: upload and download files, run scripts and flows. Import library adds an import line for a package at the top of the file.
• The badge at the foot of the code shows the runtime version and the language server’s state — see Runtime versions.

Limits

• A script has no network access: it cannot call the internet. Data comes from inputs, integrations, variables or state.
• Only the language’s main is called; anything else at the top of the file runs first, as module code.
• Without Scripts edit access, Save, Publish and Run are disabled and say why.