Function emitClientGlobalApiRegistration

scripts/codegen/python.ts:3718–3777

(
    lines: string[],
    node: Record<string, unknown>,
    resolveType: (name: string) => string
)

}

function emitClientGlobalApiRegistration(
    lines: string[],
    node: Record<string, unknown>,
    resolveType: (name: string) => string
): void {
    const groups = Object.entries(node).filter(([, value]) => typeof value === "object" && value !== null && !isRpcMethod(value));

    for (const [groupName, groupNode] of groups) {
        const handlerName = `${toPascalCase(groupName)}Handler`;
        const groupExperimental = isNodeFullyExperimental(groupNode as Record<string, unknown>);
        const groupDeprecated = isNodeFullyDeprecated(groupNode as Record<string, unknown>);
        if (groupDeprecated) {
            lines.push(`# Deprecated: this API group is deprecated and will be removed in a future version.`);
        }
        if (groupExperimental) {
            pushPyExperimentalApiGroupComment(lines);
        }
        lines.push(`class ${handlerName}(Protocol):`);
        const methods = collectRpcMethods(groupNode as Record<string, unknown>);
        for (const method of methods) {
            // Client-global handler methods reuse the session handler shape; the
            // only difference is dispatch (no implicit session_id key).
            emitClientSessionHandlerMethod(lines, method, resolveType, groupExperimental, groupDeprecated);
        }
        lines.push(``);
    }

    lines.push(`@dataclass`);
    lines.push(`class ClientGlobalApiHandlers:`);
    if (groups.length === 0) {
        lines.push(`    pass`);
    } else {
        for (const [groupName] of groups) {
            lines.push(`    ${toSnakeCase(groupName)}: ${toPascalCase(groupName)}Handler | None = None`);
        }
    }
    lines.push(``);

    lines.push(`def register_client_global_api_handlers(`);
    lines.push(`    client: "JsonRpcClient",`);
    lines.push(`    handlers: ClientGlobalApiHandlers,`);
    lines.push(`) -> None:`);
    lines.push(`    """Register client-global request handlers on a JSON-RPC connection.`);
    lines.push(``);
    lines.push(`    Unlike client-session handlers these methods carry no implicit`);
    lines.push(`    session_id dispatch key; a single set of handlers serves the entire`);
    lines.push(`    connection.`);
    lines.push(`    """`);
    if (groups.length === 0) {
        lines.push(`    return`);
    } else {
        for (const [groupName, groupNode] of groups) {
            const methods = collectRpcMethods(groupNode as Record<string, unknown>);
            for (const method of methods) {
                emitClientGlobalRegistrationMethod(lines, groupName, method, resolveType);
            }
        }
    }