Start a new session in programmatic mode

[gridsandspaces]

Describe the feature or problem you'd like to solve

Add a command for starting a new session --start-session and return the ID

Proposed solution

When using the CLI we currently have the ability to --resume {id} or --continue, but there is no programmatic way to start a new session or easily capture the most recent session ID.

When using the CLI in an application it would be very convenient to start a new session, capture the ID and then use --resume {id} on all subsequent prompts.

Pseudo Code:

let session_id = copilot --start-session
copilot -p "review the README.md contents and make them sound more professional" --resume {session_id}
copilot -p "review the README.md contents and make them sound more professional" --continue

In its current form, users must look at the .copilot/logs or .copilot/session-state to locate a session GUID and apply it.

Example prompts or workflows

No response

Additional context

No response

[mdc-git]

+1

[grzegorzwitkowski]

There is a workaround for retrieving the sesssion id. When you run copilot CLI with --log-dir my-custom-dir/ parameter it creates a new file inside it with session id in the file name, e.g. my-custom-dir/session-ec41fbe2-af76-4185-ccb9-a61461234.log. Usable, but not convenient.

[DTW-DanWard]

One solution that would solve this - and provide a lot of value outside this case - would be to provide a parameter --json-output that instead of writing content directly to standard out would instead aggregate all the output and return it in a single json format for easy consumption by the caller. --json-output would only work if -p or --prompt was provided.
It doesn't have to be JSON specifically, could be --output but you get the idea.

I really want to script prompts and have it use the exact same session (so I can run multiple at the same time if necessary) so --continue won't work and programmatically finding the session seem janky.