pub struct RegisterReq {Show 17 fields
pub account: Option<String>,
pub actor: Option<String>,
pub agent: Option<String>,
pub cwd: Option<String>,
pub host: Option<String>,
pub parent_session_id: Option<String>,
pub project: Option<String>,
pub provider: Option<String>,
pub published: Option<bool>,
pub repo: Option<String>,
pub room: Option<String>,
pub status: Option<String>,
pub target: Option<String>,
pub task_run_id: Option<String>,
pub task_workflow_id: Option<String>,
pub terminal: Option<String>,
pub title: Option<String>,
}Fields§
§account: Option<String>Account is which subscription or API account under that provider served the run, up to 256 characters. It is what lets a revoke of that login stop exactly the sessions it was paying for.
actor: Option<String>Actor is the "org/sub" identity to record the session under, up to 256 characters. Omit it and the calling principal is used, which is almost always what you want: it is what a login revoke matches on to stop this session.
agent: Option<String>Agent is the label the surface opening this session calls itself by ("hanzo-dev"). REQUIRED, up to 128 characters, and free text — nothing resolves it against a defined agent.
cwd: Option<String>Cwd is the directory the session starts in, up to 1024 characters. It can be moved later, because a linked shell walks around.
host: Option<String>Execution context — where this session runs (all optional).
parent_session_id: Option<String>ParentSessionID makes this a subagent of that session: it inherits the parent’s root, so one flow stays one tree. The parent must exist IN THE SAME ORG — a foreign or unknown id is a 400, never a tree across tenants. Empty opens a root session.
project: Option<String>The readable build (provenance.go): which product this session builds, and whether its story may be read by the world.
provider: Option<String>Account tag — the linked AI account this session ran under (login manager).
published: Option<bool>Published opens this session’s story to the public build route. It is refused without a Project, because that route is keyed on (org, project) — a build with no product is not a story anyone can open. False keeps it org-only.
repo: Option<String>Repo is the code being worked on, up to 512 characters. A label the surface states; nothing resolves it against the forge.
room: Option<String>Room is the collaborative room this run was started in (HIP-0523), so a workspace view can list the sessions of one room. It is PROVENANCE and is set only here: there is deliberately no way to move a session to another room, so it is absent from the patch input and from UpdateSession’s SET list.
status: Option<String>Status opens the session in one of running, paused, done or error. Empty means running. A TERMINAL status here (done, error) records a session that has already finished — its end time is stamped now — and nothing can move it afterwards.
target: Option<String>Target names a run-target the org has registered. Unlike Host and Repo it IS resolved: a target that does not exist in this org is a 400, so a session can never claim to run on another tenant’s machine. Empty names no machine.
task_run_id: Option<String>TaskRunID is that workflow’s particular run, same bound. Recorded, not resolved: this surface does not check the workflow exists.
task_workflow_id: Option<String>TaskWorkflowID links this session to the hanzoai/tasks workflow that executes it, up to 256 characters. Set it and control commands are forwarded to that engine; leave it and the running surface polls for them instead.
terminal: Option<String>Terminal is the URL this session’s live terminal is published at, so the console can watch it. Optional — a session that publishes nothing is still a session.
title: Option<String>Title is the human line a card shows, up to 512 characters. Optional, and changeable later.
Implementations§
Source§impl RegisterReq
impl RegisterReq
pub fn new() -> RegisterReq
Trait Implementations§
Source§impl Clone for RegisterReq
impl Clone for RegisterReq
Source§fn clone(&self) -> RegisterReq
fn clone(&self) -> RegisterReq
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read more