Skip to main content

Interface: AgencyLaunchOptions

Defined in: packages/agentos/src/api/runtime/agencyLaunch/types.ts:55

agencies on an agent: whether it may launch temporary teams, and every launch's bounds.

Properties​

budgetShare?​

optional budgetShare: number

Defined in: packages/agentos/src/api/runtime/agencyLaunch/types.ts:65

The share of what the launching turn's budget has left that one launch may spend: above 0, at most 1, default 0.5.


defaultDeadlineMs?​

optional defaultDeadlineMs: number

Defined in: packages/agentos/src/api/runtime/agencyLaunch/types.ts:71

The deadline of a launch that names none, in ms: default 120,000 (at most maxDeadlineMs).


hitl?​

optional hitl: HitlConfig

Defined in: packages/agentos/src/api/runtime/agencyLaunch/types.ts:77

The approval policy every launched team runs under after the gate the launching turn carries; applied at a root launch and inherited below it.


launch?​

optional launch: boolean

Defined in: packages/agentos/src/api/runtime/agencyLaunch/types.ts:57

Registers launch_agency on the agent's tool table. Default false.


maxConcurrent?​

optional maxConcurrent: number

Defined in: packages/agentos/src/api/runtime/agencyLaunch/types.ts:63

Launches in flight at once per scope (a session at the root, a team below it): an integer from 1 to 4, default 1.


maxDeadlineMs?​

optional maxDeadlineMs: number

Defined in: packages/agentos/src/api/runtime/agencyLaunch/types.ts:73

The longest deadline a launch may name, in ms: from 1,000 to 3,600,000, default 600,000.


maxDepth?​

optional maxDepth: number

Defined in: packages/agentos/src/api/runtime/agencyLaunch/types.ts:59

The deepest team level a launch tree reaches: an integer from 1 to 4, default 2.


maxLaunchCostUSD?​

optional maxLaunchCostUSD: number

Defined in: packages/agentos/src/api/runtime/agencyLaunch/types.ts:69

Their dollar ceiling, counted where a price row or a provider-reported cost exists; a number above 0. Default: none.


maxLaunchTokens?​

optional maxLaunchTokens: number

Defined in: packages/agentos/src/api/runtime/agencyLaunch/types.ts:67

The token ceiling of all the root launches of one parent turn, their nested launches included: at least 2,000, default 200,000.


maxSeats?​

optional maxSeats: number

Defined in: packages/agentos/src/api/runtime/agencyLaunch/types.ts:61

The most seats one launch names: an integer from 1 to 12, default 5.


members?​

optional members: Record<string, Agent>

Defined in: packages/agentos/src/api/runtime/agencyLaunch/types.ts:75

gmi() only: the persistent members a launch may seat by agentKey, each a gmi() handle.