feat(workflows): implement interactive workflow run with approval loops, quiet connection, and automatic file uploading

[yxvnyk]

Ticket

EPMCDME-12353

Summary

This MR extended CodeMie CLI to support executing custom or shared workflows by ID or Name under the codemie workflow run and codemie sdk workflows run commands.

Changes

Impact

Both commands are feature-complete and support:

1. Interactive Interruption & Approval Handler:
   • Detects Interrupted status from any node (e.g. approval states) and presents an interactive CLI choice to the user: Approve & Continue, Edit current message, or Abort workflow.
   • Supports looping over successive interruptions seamlessly.
   • Leverages a stable, engine-level execution ID (execId) across resumes to prevent state loss after a generic success base response.
2. Quiet Authentication Connection:
   • Suppresses the standard ✔ Connected to CodeMie and configuration-loading spinner when raw JSON output is requested (such as during --no-wait or --json execution), making the CLI commands fully pipeline-safe and compliant with Unix stdout standards.
3. Clean Immediate Exit (--no-wait):
   • Correctly handles commander options negation. Triggering a run with --no-wait outputs ONLY clean, raw JSON starting metadata and exits instantly.
4. Unix Pipeline-safe Completed Outputs:
   • Successful executions display ONLY the actual finalized markdown/text output (fetched from the graph's finalizer state), omitting extra metadata or checkmark wrappers.
5. Automatic File Upload Assignment:
   • Re-adds the -f, --file <name> option. Specifying a local file automatically reads and uploads it to the CodeMie files API before launching the workflow with its remote file_url reference attached.

Verification & Testing Evidence

1. Integration Tests
   Executed and passed 100% of the workflow test suite:

   npx vitest run tests/integration/cli-commands/workflow.test.ts

   1  RUN  v4.1.5 C:/epam/codemie-dev/codemie-code
   2
   3  Test Files  1 passed (1)
   4       Tests  6 passed (6)
   5    Duration  5.28s

2. Manual Verification Scenarios

A. Standard Output Extraction (Successful Polled Run)

`node ./bin/codemie.js workflow run d362c364-ee7f-4716-a1b7-f6f706d09f0d --input "hello"`

• Output: Displays only the markdown result from the graph finalizer:

   1 ✔ Connected to CodeMie
   2 ✓ Workflow completed successfully.
   3
   4 # Conversation Summary
   5
   6 ## Initial User Task
   7 The user greeted with "hello"...

B. Clean JSON Trigger (--no-wait Suppressing Spinner)

1 node ./bin/codemie.js workflow run d362c364-ee7f-4716-a1b7-f6f706d09f0d --input "hello" --no-wait

• Output: Returns confirmation about starting the workflow:

✓ ✓ Workflow execution started successfully. (Status: In Progress)

C. File Assignment & Interactive Approval loop

node ./bin/codemie.js workflow run d362c364-ee7f-4716-a1b7-f6f706d09f0d --input "hello my friend" --file "package.json"

• Output: Quietly uploads package.json, enters interrupted state, prompts user to Approve/Edit/Abort, accepts edited input, and resumes polling seamlessly:

    1 ✔ Connected to CodeMie
    2 ✔ ✓ File package.json uploaded successfully.
    3
    4 ⚠ Workflow execution is Interrupted and requires your decision.
    5 Interrupted Message:
    6 hello* my* friend* -*
    7
    8 ? How would you like to proceed? Edit current message
    9 ? Enter your edited message: hello* my* friend*
   10 ✔ ✓ Workflow resumed with edited message.
   11 # Conversation Summary
   12 ... (prints only final result)