Interface LaunchAgencyResult

The tool's output for every launch that started; a refusal is a tool error instead.

interface LaunchAgencyResult {
    status: LaunchStatus;
    agencyId: string;
    text: string;
    truncated: boolean;
    seats: LaunchSeatRecord[];
    usage: LaunchUsage;
    coordinatorUsage: {
        totalTokens: number;
        costUSD: number;
    };
    durationMs: number;
    reason?: string;
    provenance: {
        agencyId: string;
        strategy: AgencyStrategy;
        depth: number;
        parentGmiId: string;
        parentSessionId: string;
        startedAt: string;
        closedAt: string;
        deadlineMs: number;
        budget: {
            maxCostUSD?: number;
            maxTotalTokens: number;
            spentUSD: number;
            tokensUsed: number;
        };
    };
}

Properties

status: LaunchStatus
agencyId: string
text: string

The team's answer, at most LAUNCH_TEXT_CHARS characters; '' when the team produced none.

truncated: boolean

The seats' own calls, summed from their records.

coordinatorUsage: {
    totalTokens: number;
    costUSD: number;
}

The coordinator's calls (the manager's and the synthesizers'), from its sub-budget.

Type declaration

  • totalTokens: number
  • costUSD: number
durationMs: number
reason?: string

For every status but 'completed'. For 'budget_exhausted' it says whose budget refused (the launch's, or one the team draws on) and why: the launch's own token cap, once the launch's calls have used it up, as its count of the cap; any other refusal, a call whose estimate alone would pass what the cap has left among them, in the refusing cap's own words.

provenance: {
    agencyId: string;
    strategy: AgencyStrategy;
    depth: number;
    parentGmiId: string;
    parentSessionId: string;
    startedAt: string;
    closedAt: string;
    deadlineMs: number;
    budget: {
        maxCostUSD?: number;
        maxTotalTokens: number;
        spentUSD: number;
        tokensUsed: number;
    };
}

Type declaration

  • agencyId: string
  • strategy: AgencyStrategy
  • depth: number
  • parentGmiId: string
  • parentSessionId: string
  • startedAt: string
  • closedAt: string
  • deadlineMs: number
  • budget: {
        maxCostUSD?: number;
        maxTotalTokens: number;
        spentUSD: number;
        tokensUsed: number;
    }

    Everything the launch's budget counted: the seats', the coordinator's and every nested launch's calls; maxCostUSD omitted when no dollar cap applied.

    • Optional maxCostUSD?: number
    • maxTotalTokens: number
    • spentUSD: number
    • tokensUsed: number